SUBSCRIBE_TOKEN_NEW_LISTING

Subscribing to Real-Time token new listing (SUBSCRIBE_TOKEN_NEW_LISTING)

The "SUBSCRIBE_TOKEN_NEW_LISTING" event allows you to receive real-time updates about new token listings. This subscription is useful for tracking new tokens being added on a requested blockchain.

The instructions for each type of objects are described below.

WebSocket URL:

wss://public-api.birdeye.so/socket/solana?x-api-key=YOUR-API-KEY

Header

KeyValue
Originws://public-api.birdeye.so
Sec-WebSocket-Originws://public-api.birdeye.so
Sec-WebSocket-Protocolecho-protocol

Message

{
    "type": "SUBSCRIBE_TOKEN_NEW_LISTING"
}

Or:

{
    "type": "SUBSCRIBE_TOKEN_NEW_LISTING",
    "meme_platform_enabled": true,
    "min_liquidity": 5000,
    "max_liquidity": 10000,
		"sources": ["pump_dot_fun", "meteora_dynamic_bonding_curve"],
}

Key Notes:

  • The min_liquidity parameter is optional but user must set higher than system value which is 0.
  • The max_liquidity parameter is optional but must be higher than min_volume when provided.
  • The meme_platform_enabled parameter is optional, value true means that you want to receive new meme token listing from meme platform such as pump.fun. If no message, it means no listing from meme platform.
  • The sources parameter is optional, it enables filtering newly listed meme tokens based on their originating source.

Output Example

{
    "type": "TOKEN_NEW_LISTING_DATA",
    "data": {
        "address": "BkQfwVktcbWmxePJN5weHWJZgReWbiz8gzTdFa2w7Uds",
        "decimals": 6,
        "name": "Worker Cat",
        "symbol": "$MCDCAT",
        "liquidity": "12120.155172280874",
        "liquidityAddedAt": 1720155863
    }
}

Response Parameters:

KeyData TypeDetailsExample
addressstringThe token address."BkQfwVktcbWmxePJN5weHWJZgReWbiz8gzTdFa2w7Uds"
decimalsintegerThe number of decimal places for the token.6
namestringThe name of the token."Worker Cat"
symbolstringThe symbol of the token."$MCDCAT"
liquiditystringThe current liquidity of the token."12120.155172280874"
liquidityAddedAtintegerThe Unix timestamp when liquidity was added.1720155863

Supported meme sources:

SourceValue
RAYDIUMraydium
RAYDIUMraydium_clamm
RAYDIUMraydium_cp
ORCAorca
ALDRINaldrin
STEPstep
SAROSsaros
SAROSsaros_dlmm
CROPPERcropper
TESSERAVtesserav
CROPPERcropper_dlmm
CREMAcrema
LIFINITYlifinity
PANCAKESWAPpancakeswap_v3
SABERsaber
SWAPswap_program
SENCHAsencha
MERCURIALmercurial
SERUMserum
OPENBOOKopenbook
HUMIDIFIhumidifi
OPENBOOKopenbook_swap
SERUMserum_swap
PENGUINpenguin
TOKENtoken
WHIRLPOOLwhirlpool
ONEMOONonemoon
CYKURAcykura
SWIMswim
DOOARdooar
MARINADEmarinade
MANGOmango
SYMMETRYsymmetry
METEORAmeteora
INVARIANTinvariant
MARCOPOLOmarcopolo
OASISoasis
GOOSEFXgoosefx
SOLANAXsolanax
DELTAFIdeltafi
DRADEXdradex_swap
CREMAcrema_clamm
BALANSOLbalansol
JUPITERjupiter_limit_order
JUPITERjupiter_dca
JUPITERjupiter_perp
FUSIONfusion_amm
PHOENIXphoenix
STAKEstake_pool
SOCEANsocean
LIDOlido
ZETAzeta
BONKSWAPbonkswap
LPlp_finance
FLUXBEAMfluxbeam
SNOWFLAKEsnowflake
METEORAmeteora_dlmm
TINYtiny
DEXLABdexlab
SANCTUMsanctum
OPENBOOKopenbook_v2
ONE1intro
GUACAMOLEguacamole
CLONEclone_protocol
PUMPpump_dot_fun
STABBLEstabble
MANIFESTmanifest
JUPITERZjupiterz
MOONSHOTmoonshot
SOLFIsolfi
NUMERAIREnumeraire
ZEROFIzerofi
DAOSFUNdaosfun
SOLANAFUNsolanafun_snapper
SOLANAFUNsolanafun_fomo
PUMPpump_amm
VIRTUALSvirtuals_io
SUPERsuper_exchange
METEORAmeteora_damm_v2
METEORAmeteora_virtual_curve
RAYDIUMraydium_launchlab
METEORAmeteora_dynamic_bonding_curve
PLASMAplasma
VERTIGOvertigo
WAVEBREAKwavebreak
BYREALbyreal
HEAVENheaven
UNISWAPuniswap
KYBERSWAPkyber
ONEINCHoneinch
SUSHISWAPsushiswap
BALANCERbalancer
BALANCERbalancerV2
BALANCERbalancerV3
TOKENtoken
PANCAKESWAPpancakeswap
PANCAKEpancakeStableSwap
DODOdodoV2
PANCAKESWAPpancakeswapInfinityCLAMM
PANCAKESWAPpancakeswapInfinityLBAMM
CURVECurve.fi
MAVERICKmaverickV2
UNISWAPVuniswapV4
WOOFIwoofi
EKUBOekubo
ONDOOndoFinance
FLUIDfluid