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
sourcesstringComma-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_clmmmanifestderiversebonkfunExample
pump_fun,pump_ammsourcestringA single venue, the one-value form of sources.
Send one of source or sources, not both.
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
50limitnumberMaximum number of results (default 50, max 200).
Example
50cursorstringOpaque keyset cursor from the previous response's next field.
Endpoint-scoped — do not reuse across endpoints.
fromstringStart of the time window (ISO-8601 or unix ms).
Clamped to the 7-day history window.
Example
1751000000000tostringEnd of the time window (ISO-8601 or unix ms).
Example
1751008869000
Response fields
Fields of each item in the data array.
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