Skip to main content
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.