Latest Graduations

GET /v1/graduations returns the tokens that graduated in the last 7 days, newest first, with each pool's liquidity.

Endpoint
GET/v1/graduations
Auth
API key in the Authorization header
Live
The same data as a stream

Supports sources (or source), excludeMayhem, and minLiquiditySol. History covers the last 7 days. Graduations recorded before 14 July 2026 show mayhemMode: false and liquiditySol: null.

Query parameters

A parameter not listed here is rejected with 400 invalid_request, not ignored. Pass sources as a comma-separated list or source for one venue, not both. All venues

sourcesstring

Comma-separated venues, up to 20.

Every name must be a documented source; an unknown name returns 400. Send sources or source, not both.

All 23 values
pump_funpump_ammraydium_launchlabraydium_cpmmraydium_clmmraydium_v4meteora_dbcmeteora_damm_v2meteora_dlmmmeteora_poolsorca_whirlpoolpancakeswapjupiter_order_enginetessera_vbisonfigoonfi_v2zerofiscorchalphaqbyreal_clmmmanifestderiversebonkfun

Example pump_fun,pump_amm

sourcestring

A single venue, the one-value form of sources.

Send one of source or sources, not both.

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

limitnumber

Maximum number of results (default 50, max 200).

Example 50

cursorstring

Opaque keyset cursor from the previous response's next field.

Endpoint-scoped — do not reuse across endpoints.

fromstring

Start of the time window (ISO-8601 or unix ms).

Clamped to the 7-day history window.

Example 1751000000000

tostring

End of the time window (ISO-8601 or unix ms).

Example 1751008869000

Response fields

Fields of each item in the data array.

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