> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pump.fun API

> Track Pump.fun token launches in real-time with the Codex API. Get launch data, bonding curve progress, graduation events, and live WebSocket updates.

The leading token launchpad on Solana, pioneering the bonding curve model for fair token launches. Codex tracks every Pump.fun token from creation through bonding curve completion and migration to Raydium, with real-time event streaming.

## Network Information

| Property              | Value        |
| --------------------- | ------------ |
| Network               | Solana       |
| Chain ID              | `1399811149` |
| Protocol Filter       | `Pump`       |
| Launchpad Name Filter | `"Pump.fun"` |

<Tip>
  Filter queries to Pump.fun tokens using `launchpadName: "Pump.fun"` in [`filterTokens`](/api-reference/queries/filtertokens) or `protocol: Pump` in subscriptions.
</Tip>

## Token Lifecycle

Pump.fun tokens progress through several stages:

1. **Created** — Token deployed on bonding curve
2. **Completing** — Approaching graduation threshold (80-100%)
3. **Completed** — Bonding curve filled
4. **Migrated** — Graduated to DEX liquidity pool

Use `graduationPercent`, `completed`, and `migrated` fields to track token progression.

## Supported APIs

### Launchpad API

* [Get Newly Created Pump.fun Tokens](/api-reference/queries/filtertokens) — Find the latest token launches on Pump.fun
* [Get Tokens Completing Bonding Curve on Pump.fun](/api-reference/queries/filtertokens) — Track tokens nearing graduation (80-100%)
* [Get Graduated Pump.fun Tokens](/api-reference/queries/filtertokens) — Find tokens that have completed bonding curves and migrated to DEX

### Real-time API

* [Subscribe to All Pump.fun Token Events](/api-reference/subscriptions/onlaunchpadtokeneventbatch) — Stream real-time launch events, trades, and graduations
* [Subscribe to Individual Pump.fun Token Events](/api-reference/subscriptions/onlaunchpadtokenevent) — Track events for a specific token

<Warning>
  Launchpad events are extremely high-frequency and will send a large number of requests. We offer a monthly flat-rate option with unlimited requests for this subscription. [Contact us](mailto:hello@codex.io?subject=Launchpad%20Events%20Subscription) for more information.
</Warning>

### Trading & Market Data API

* [Get Trading Events for Pump.fun Tokens](/api-reference/queries/gettokenevents) — Query swap events and trading history
* [Get Detailed Statistics for Pump.fun Tokens](/api-reference/queries/filtertokens) — Retrieve volume, buys/sells, and market metrics
* [Get Token Holders for Pump.fun Tokens](/api-reference/queries/holders) — Query token holder data and balances

## Try It in the Explorer

Test any Pump.fun query directly in the [Codex GraphQL Explorer](/explore).

## Related Resources

* [Launchpads Recipe](/recipes/launchpads) — Build a launchpad dashboard
* [Supported Networks Overview](/networks) — All supported networks
