Skip to main content
Follow a Pump.fun token from its first indexed pool through curve completion and migration. Use REST to load a snapshot and Datastream to receive new launches and graduation events.

Lifecycle overview

The API separates creation, curve progress, and migration:
  1. Created — the token launches on the bonding curve.
  2. Graduating — the bonding curve fills up from 0–100%.
  3. Graduated — the curve is complete, and liquidity moves to a DEX pool.
You can track each stage with REST endpoints, real-time WebSocket streams, or both.

Find new Pump.fun tokens

REST: latest tokens

Filter the response by pools[0].market to isolate Pump.fun tokens:

REST: search with filters

Use the search endpoint to find Pump.fun tokens with specific criteria:
Key search filters for Pump.fun:

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:
Supported markets for curve alerts: 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).
The response includes 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.
Raptor selects supported routes for the token’s current pools, including bonding curve and migrated liquidity. See the full Swap API guide for sending transactions and WebSocket streaming.

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:

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.