Lifecycle overview
The API separates creation, curve progress, and migration:- Created — the token launches on the bonding curve.
- Graduating — the bonding curve fills up from 0–100%.
- Graduated — the curve is complete, and liquidity moves to a DEX pool.
Find new Pump.fun tokens
REST: latest tokens
pools[0].market to isolate Pump.fun tokens:
REST: search with filters
Use the search endpoint to find Pump.fun tokens with specific criteria:REST: tokens by deployer
Find all tokens launched by a specific wallet:WebSocket: live feed
Subscribe to new indexed tokens, then keep Pump.fun rows:Track bonding curve progress
REST: graduating tokens
Query tokens approaching bonding curve completion:WebSocket: graduating stream
WebSocket: curve percentage alerts
Get notified when any token hits a specific bonding curve milestone:pumpfun, launchpad, boop, meteora-curve.
Detect graduation
REST: recently graduated
WebSocket: graduated stream
REST: graduation timestamp for a specific token
GET /tokens/{tokenAddress} and POST /tokens/multi do not include a graduation timestamp field. To fetch when a specific token graduated, use the search endpoint — it returns a graduatedAt field (Unix ms, null if the token has not graduated).
data[].graduatedAt. You can also filter by graduation window using minGraduatedAt / maxGraduatedAt.
Example: graduation pipeline
Watch tokens across their full Pump.fun lifecycle:Swap Pump.fun tokens
Use the Raptor Swap API to buy and sell Pump.fun tokens. It handles bonding curve swaps and post-graduation DEX swaps automatically.Risk signals
Pump.fun tokens carry specific risks you can monitor:
Use these Datastream rooms to monitor safety signals on any Pump.fun token:
See the Safety Streams guide for full examples.
Program IDs & instructions
For instruction construction or transaction parsing, use these program references:
IDL downloads: /idl/pump.json, /idl/pump_amm.json.
Yellowstone grpc (advanced)
For low-level transaction parsing, use Yellowstone gRPC to stream raw Pump.fun transactions directly from Solana:- Pump.fun Buy/Sell Detection — parse buy/sell events with full IDL decoding
- Pump.fun Account Streaming — monitor bonding curve account state changes
Room reference
API endpoints
Bonding curve program
Program ID, Anchor IDL, and buy/sell discriminators for web3.js.
PumpSwap program
PumpSwap program ID, IDL, and post-graduation buy/sell instructions.
Find tokens
Trending, volume leaders, and top performers across all markets.
Token launches
Real-time graduating, graduated, and curve percentage streams.
Live risk signals
Sniper, bundler, insider, and holder monitoring.
Swap tokens
Buy and sell tokens through Raptor with automatic routing.