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
graduations sends graduated events
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_clmmmanifestderiversebonkfun

Example ["pump_fun"]

excludeMayhemboolean

When 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 true

minLiquiditySolnumber

Graduations 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.

typestring

Always "graduated".

sourcestring

Venue the token graduated on.

See Sources.

mintstring | null

Mint address of the token.

Always set in practice.

namestring | null

Token name. null when the create was never seen.

symbolstring | null

Token symbol. null when the create was never seen.

creatorstring | null

Wallet that created the token. null when the create was never seen.

uristring | null

On-chain metadata URI.

May be null.

mayhemModeboolean

True for pump.fun Mayhem-mode tokens.

socialsobject

{ website, twitter, telegram }, each a string or null.

liquiditySolnumber | null

The 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 | null

The same liquidity valued in USD. null when the quote token had no price at graduation or the amount is unknown.

liquidityQuoteobject | null

The 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 | null

Seconds from creation to graduation. null when the token's creation was never observed.

signaturestring

Graduation transaction signature.

slotnumber

Solana slot the event landed in.

Use for ordering and gap recovery.

timestampnumber | null

Event time as a Unix epoch millisecond value. null when the block time is unknown (rare).

Last updated · Changelog