Token Graduation
The graduations stream sends a graduated event the moment a token completes its bonding curve and moves to an AMM pool, with the pool's liquidity.
- Channel
graduationssendsgraduatedevents- Plans
- Every planAll graduations, no filter needed
- History
Filters
Filters narrow graduations events before they are sent to you. A filter the graduations channel doesn't take is rejected with invalid_filters, not ignored. REST takes the same filters as query parameters. Filters on REST and WebSocket
sourcesstring[]Filter by venue, 1–20 names.
Every name must be a documented source; an unknown name is rejected with invalid_filters.
All 23 values
pump_funpump_ammraydium_launchlabraydium_cpmmraydium_clmmraydium_v4meteora_dbcmeteora_damm_v2meteora_dlmmmeteora_poolsorca_whirlpoolpancakeswapjupiter_order_enginetessera_vbisonfigoonfi_v2zerofiscorchalphaqbyreal_clmmmanifestderiversebonkfunExample
["pump_fun"]excludeMayhembooleanWhen true, drop events where mayhemMode is true.
Omit or false to include Mayhem-mode coins. Applies to creations and graduations (WS + REST). Events recorded before 14 July 2026 show mayhemMode: false, so excludeMayhem won't hide Mayhem-mode tokens from before that date.
Example
trueminLiquiditySolnumberGraduations only.
Minimum liquiditySol in SOL units. It compares the SOL value, so curves quoted in USDC or a community token compare the same way. Events with liquiditySol null fail the floor (same semantics as a null volume under a volume filter). Graduations recorded before 14 July 2026 have liquiditySol: null, so any minLiquiditySol excludes them.
Example
50
Event fields
Every field of the graduated event the graduations stream sends, as shown in the example.
typestringAlways "graduated".
sourcestringVenue the token graduated on.
See Sources.
mintstring | nullMint address of the token.
Always set in practice.
namestring | nullToken name. null when the create was never seen.
symbolstring | nullToken symbol. null when the create was never seen.
creatorstring | nullWallet that created the token. null when the create was never seen.
uristring | nullOn-chain metadata URI.
May be null.
mayhemModebooleanTrue for pump.fun Mayhem-mode tokens.
socialsobject{ website, twitter, telegram }, each a string or null.
liquiditySolnumber | nullThe new pool's quote side, valued in SOL: the amount itself on a SOL curve, converted at graduation when the curve is quoted in USDC, USDT or a community token.
Classic pump.fun graduations are near 85 SOL; Mayhem-mode graduations are typically under 1 SOL, which is correct, not missing data. null when the quote token had no price at graduation or the amount is unknown (Raydium LaunchLab graduations today); null fails
minLiquiditySol.liquidityUsdnumber | nullThe same liquidity valued in USD. null when the quote token had no price at graduation or the amount is unknown.
liquidityQuoteobject | nullThe pool's quote side as the token it is: { mint, symbol, amount (raw string), uiAmount, decimals }. pump.fun curves can be quoted in SOL, USDC, USDT or a community token. null when the amount is unknown.
timeToGraduateSecondsnumber | nullSeconds from creation to graduation. null when the token's creation was never observed.
signaturestringGraduation transaction signature.
slotnumberSolana slot the event landed in.
Use for ordering and gap recovery.
timestampnumber | nullEvent time as a Unix epoch millisecond value. null when the block time is unknown (rare).
Last updated · Changelog