Token - New Listing

Retrieve a list of newly listed tokens.

*API Endpoint:** /defi/v2/tokens/new_listing

Description: This endpoint retrieves a list of newly listed tokens up to a specified time (currently 3 days). It provides details such as token address, symbol, name, decimals, listing time, liquidity added time, and current liquidity. Users can limit the number of results returned, with a default limit of 10 and a range from 1 to 10. Only tokens with liquidity greater than or equal to $10 are considered.
Chain supported: solana, ethereum, arbitrum, avalanche, bsc, optimism, polygon, base, zksync.

Request

Request Method: GET

Data Coverage: Multi-chain

Request URL:

<https://public-api.birdeye.so/defi/v2/tokens/new_listing?time_to=1720061753&limit=2>

Request Headers:

accept: application/json  
x-chain: any chains that Birdeye supports. Example: solana, ethereum  
X-API-KEY: YOUR_API_KEY

Parameters:

KeyData TypeDetailsExample
time_tointegerThe Unix timestamp to retrieve tokens listed up to.1720061753
limitintegerThe maximum number of records to return (default: 10, range: 1-10).2

Response

The response provides a list of newly listed tokens, along with their details.

Example Request:

curl --request GET \
     --url 'https://public-api.birdeye.so/defi/v2/tokens/new_listing?time_to=1720061753&limit=2' \
     --header 'X-API-KEY: YOUR_API_KEY' \
     --header 'x-chain: solana'

Example Response:

{
    "success": true,
    "data": {
        "items": [
            {
                "address": "7i8BvxErtapzc4Cf6vTC9uUri8pAFprXhNdiAMs1pump",
                "symbol": "villy",
                "name": "villy ",
                "decimals": 6,
                "liquidityAddedAt": 1720061749,
                "liquidity": 772.2477156153459
            },
            {
                "address": "6Wbxo93YJ3EbdfV3r2VL6t2PGLh5dK3ZKkDaQEzEpump",
                "symbol": "cooper",
                "name": "Cooper 犬",
                "decimals": 6,
                "liquidityAddedAt": 1720061738,
                "liquidity": 3485.8797307051123
            }
        ]
    }
}`

Response Parameters

KeyData TypeDetailsExample
addressstringThe token address."7i8BvxErtapzc4Cf6vTC9uUri8pAFprXhNdiAMs1pump"
symbolstringThe token symbol."villy"
namestringThe token name."villy"
decimalsintegerThe number of decimal places for the token.6
liquidityAddedAtintegerThe Unix timestamp when liquidity was added.1720061749
liquidityfloatThe current liquidity of the token.772.2477156153459

Note: This endpoint provides a list of newly listed tokens with essential details, helping users stay informed about the latest additions in the cryptocurrency market. Users can specify the number of tokens returned, with a default limit of 10 and a range from 1 to 10.