Launchpad Lifecycle

Launchpad tokens go through a series of stages before they become fully tradeable on a DEX. This guide explains each stage, how to detect them with the Codex API, and which events fire along the way.

This complements the Launchpads recipe which covers building a launchpad discovery UI.

The Stages

Tokens on bonding-curve launchpads (Pump.fun, Four.meme, LaunchLab, etc.) progress through these stages:

Deployed → Created → Bonding (Updated) → Completed → Migrated

Stage	What’s happening	Key fields
Deployed	Token contract discovered on-chain	`eventType: Deployed`
Created	Metadata populated (name, symbol, image)	`eventType: Created`
Bonding	Trading on bonding curve, `graduationPercent` rising from 0→100	`eventType: Updated`, `graduationPercent < 100`
Completed	Bonding curve filled — waiting for migration	`completed: true`, `migrated: false`
Migrated	Liquidity moved to DEX pool — fully tradeable	`migrated: true`, `migratedPoolAddress` set

Completed vs Migrated: completed means the bonding curve is full. migrated means liquidity has actually moved to a DEX. For monitoring graduations via subscriptions, use Migrated events — Completed events are a legacy state and will be deprecated.

Not all launchpads have bonding curves. Protocols like Zora, Clanker, and Baseapp skip the bonding curve entirely. Tokens on these protocols go straight to “Created” without progressing through completion or migration. Fields like graduationPercent, completed, migrated, and migratedAt will be absent for these tokens. Doppler-based protocols (like Bankr) are a related case. They manage liquidity along ticks on Uniswap pools rather than progressing through a traditional bonding curve, so graduationPercent, completed, and completedAt will be null. Migration is still tracked when it occurs, but is rare in practice.

Detecting Token State

Use the launchpad field on the token query to check a token’s current lifecycle stage.

Check a token's launchpad state

Use this logic to determine the current stage:

function getTokenStage(launchpad) {
  if (!launchpad) return 'not-a-launchpad-token'
  if (launchpad.migrated) return 'migrated'
  if (launchpad.completed) return 'completed'
  if (launchpad.graduationPercent > 0) return 'bonding'
  return 'new'
}

Filtering by Stage

Use filterTokens with launchpad filters to query tokens at each stage. These are the same filters that power the columns in the Launchpads recipe.

Tokens currently bonding (not yet graduated)

Recently migrated (graduated) tokens

Filter by specific launchpad

Use launchpadName or launchpadProtocol to narrow down to a specific launchpad.

For the complete list of supported launchpads with their launchpadName and protocol filter values, see Supported Launchpads.

Real-Time Lifecycle Events

Subscribe to onLaunchpadTokenEventBatch to receive events as tokens progress through each stage. Filter by eventType to listen for specific transitions.

New token creations

Token stat updates (bonding curve activity)

Updated events fire as tokens trade on the bonding curve. These include statistics like price, volume, and holder counts — fields that aren’t available on Created or Migrated events.

Token graduations (migrations)

Subscribe to Migrated events to detect when a token graduates from its bonding curve and moves to a DEX pool.

Track a specific token's lifecycle

Use onLaunchpadTokenEvent with an address to follow a single token through all its stages.

Launchpad events are extremely high-frequency. You must proxy this data through your backend to serve multiple users from a single subscription. We offer a monthly flat-rate option with unlimited requests. Contact us for more information.

Event Types Reference

Event Type	When it fires	Stats available?
`Deployed`	Token contract discovered on-chain	No
`Created`	Token metadata populated	No
`Updated`	Token stats change (trades, price, holders)	Yes — price, volume, holders, sniper/bundler counts
`Completed`	Bonding curve filled (legacy — use `Migrated`)	No
`Migrated`	Liquidity moved to DEX pool	No
`UnconfirmedDeployed`	Token discovered before finalization	No
`UnconfirmedMetadata`	Metadata processed before finalization	No

Statistics fields (price, volume1, holders, sniperCount, etc.) are only populated on Updated events. Other event types signal a state change but don’t include these metrics.

After Migration

Once a token migrates, it behaves like any other DEX token. You can switch from launchpad subscriptions to the standard Codex endpoints:

Data	Endpoint
Price & volume	`pairMetadata` using the `migratedPoolAddress`
Live price	`onPairMetadataUpdated`
Trades	`getTokenEvents`
Live trades	`onTokenEventsCreated`
Chart	`getTokenBars`
Live chart	`onTokenBarsUpdated`

See the Detailed Token Page recipe for the full post-migration data flow.

Protocols Without Bonding Curves

Some launchpad protocols don’t use bonding curves. Tokens on these protocols are created and immediately tradeable — they skip the bonding, completed, and migrated stages entirely.

Protocol	Has bonding curve?
Pump.fun	Yes
Four.meme	Yes
LaunchLab	Yes
Meteora DBC	Yes
boop.fun	Yes
Zora	No
Clanker	No
Baseapp	No
Virtuals	No

For tokens without bonding curves, the launchpad fields graduationPercent, completed, completedAt, migrated, migratedAt, and migratedPoolAddress will be absent. These tokens will only emit Created and Updated events.

Check out the related endpoints and types:

filterTokens — query tokens by launchpad stage
token — get a token’s launchpad data
onLaunchpadTokenEvent — single token lifecycle events
onLaunchpadTokenEventBatch — batched lifecycle events
LaunchpadTokenProtocol — supported protocols
Launchpads recipe — building a launchpad discovery UI

Documentation Index

​The Stages

​Detecting Token State

​Filtering by Stage

​Real-Time Lifecycle Events

​Event Types Reference

​After Migration

​Protocols Without Bonding Curves

The Stages

Detecting Token State

Filtering by Stage

Real-Time Lifecycle Events

Event Types Reference

After Migration

Protocols Without Bonding Curves