Skip to main content

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.

Subscriptions (WebSockets) require a Growth or Enterprise plan. Learn more.

​
Returns

​
Arguments

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 for more information.
For monitoring pool graduations, use Migrated events instead of Completed events. While both event types are currently saved to our database, only Migrated events are actively emitted via subscriptions. The Completed event is a legacy state and will be deprecated in a future release.
You can find a complete list of supported launchpad protocols here, and a list of filterable launchpad names here. For more information on our Launchpad event subscriptions, see our Launchpads recipe page. 
subscription {
  onLaunchpadTokenEventBatch(
    input: {
      protocol: Pump
      eventType: Created
    }
  ) {
    address
    networkId
    eventType
    launchpadName
    marketCap
    price
    liquidity
    holders
    volume1
    transactions1
    buyCount1
    sellCount1
    sniperCount
    sniperHeldPercentage
    devHeldPercentage
    token {
      name
      symbol
      info {
        imageThumbUrl
      }
    }
  }
}
Example Response
{
  "data": {
    "onLaunchpadTokenEventBatch": [
      {
        "address": "AiXmBp6aV8RNpump1XnR2oPpdjHhfNcYRpump6gT2pump",
        "networkId": 1399811149,
        "eventType": "Created",
        "launchpadName": "Pump.fun",
        "marketCap": "6823.45",
        "price": 0.000006823,
        "liquidity": "4521.12",
        "holders": 42,
        "volume1": 1250,
        "transactions1": 18,
        "buyCount1": 12,
        "sellCount1": 6,
        "sniperCount": 2,
        "sniperHeldPercentage": 0.05,
        "devHeldPercentage": 0.02,
        "token": {
          "name": "Example Token",
          "symbol": "EXAMPLE",
          "info": {
            "imageThumbUrl": "https://example.com/image.png"
          }
        }
      }
    ]
  }
}

​
Usage Guidelines

  • Filter by protocol (e.g., Pump, Clanker, Virtuals) or launchpadName for more specific filtering
  • Use eventType to subscribe to specific lifecycle events: Created, Updated, Migrated
  • Events are batched for efficiency - each message may contain multiple token events
  • Use networkId to filter by specific chain (e.g., 1399811149 for Solana, 8453 for Base)
  • Monitor sniperCount, bundlerCount, and insiderCount to assess token quality
  • Use devHeldPercentage to check developer token holdings

​
Troubleshooting Tips

  • Deployed: Token contract discovered on-chain
  • Created: Token has metadata populated
  • Updated: Token stats updated (price, volume, holders)
  • Migrated: Token graduated from bonding curve to DEX
  • UnconfirmedDeployed/UnconfirmedMetadata: Early events before finalization
onLaunchpadTokenEventBatch batches multiple events per message, reducing WebSocket overhead. Use this for high-throughput applications monitoring many tokens.
Subscribe to eventType: Migrated to receive events when tokens graduate from bonding curves to DEX pools. This is the recommended approach over Completed events.
sniperCount is wallets that bought very early (potential bots). bundlerCount is wallets that bundled transactions. High values may indicate coordinated buying or manipulation.
Use eventType: Deployed instead for faster updates. The two events are:
  • Deployed — sent immediately when the token contract is discovered (minimal latency). Includes fundamentals but may lack metadata like images.
  • Created — sent after metadata is fetched (3-4s latency). Includes complete token information.
For the fastest results, subscribe to both and resolve the models on the frontend: use Deployed for immediate notification and Created to fill in metadata when it arrives. We have plans to reduce Created latency further (especially on Solana) while keeping the same Deployed → Created flow.
  • Launchpads: Build a launchpad discovery view with real-time token lifecycle updates
  • Launchpad Lifecycle: Understand how tokens progress through launchpad stages from bonding curve to graduation