onLaunchpadTokenEventBatch

This endpoint requires a Growth or Enterprise plan. Learn more.

Returns

[LaunchpadTokenEventOutput!]!

See LaunchpadTokenEventOutput

Show Properties

String!

The contract address of the token.

Int!

The network ID that the token is deployed on.

String!

The protocol of the token.

String!

The name of the launchpad.

EnhancedToken!

Metadata for the token. See EnhancedToken

Int

The number of buys in the last hour.

LaunchpadTokenEventType!

The type of event. See LaunchpadTokenEventType

Int

The number of holders.

String

The market cap of the token.

Float

The price of the token.

Int

The number of sells in the last hour.

Int

The volume of the token in the last hour.

Int

The number of transactions in the last hour.

String

The liquidity of the token’s top pair.

String

Pool fees (DEX protocol revenue) in the last hour, USD.

String

Network base fees in the last hour, USD.

String

EIP-1559 priority fees (tips to validators) in the last hour, USD.

String

Builder tips (MEV activity indicator) in the last hour, USD.

String

L1 data fees (cost of posting rollup data to L1, applies to all L2 rollups) in the last hour, USD.

String

The total fees (pool + base + priority + builder tips + L1 data) in the last hour, denominated in USD.

Float

The ratio of total fees to volume in the last hour.

Float

The number of snipers that bought the token

Float

The percentage of the token that is held by snipers

Float

The number of bundlers that bought the token

Float

The percentage of the token that is held by bundlers

Float

The number of insiders that bought the token

Float

The percentage of the token that is held by insiders

Float

The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders) that bought the token

Float

The percentage of the token that is held by suspicious wallets

Float

The percentage of the token that is held by developers

Float

The percentage of total supply held by the top 10 holders.

Wallet

Resolved profile and token-creator stats for the deployer wallet. See Wallet

Arguments

OnLaunchpadTokenEventBatchInput

See OnLaunchpadTokenEventBatchInput

Show Properties

LaunchpadTokenProtocol

The launchpad protocol. See LaunchpadTokenProtocol

[LaunchpadTokenProtocol!]

A list of launchpad protocols. See LaunchpadTokenProtocol

Int

The network ID that the token is deployed on.

String

The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift.

[String!]

A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift.

LaunchpadTokenEventType

The type of event. See LaunchpadTokenEventType

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.

Example

Test this query in the Explorer →

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

This subscription is scoped to the launch lifecycle: events stream from token creation through the bonding curve, then for 6 hours post-migration (graduation). After that window, tokens age out of the stream — for continued coverage, hand off to the standard subscriptions (see below)
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, insiderCount, and suspiciousCount to assess token quality. These count wallets still holding, so they fall as those wallets sell
Use devHeldPercentage to check developer token holdings

Troubleshooting Tips

What's the difference between eventType options?

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

Why use this instead of onLaunchpadTokenEvent?

onLaunchpadTokenEventBatch batches multiple events per message, reducing WebSocket overhead. Use this for high-throughput applications monitoring many tokens.

Why do events stop 6 hours after a token migrates?

The 6-hour window is by design. This subscription covers the launch lifecycle — creation, bonding curve progress, and graduation/migration. Once a token migrates there are no further launchpad lifecycle events for it, and keeping every graduated token in this high-volume stream would only duplicate data available from the standard subscriptions. In practice, most launchpad tokens see their activity die off within a few hours of migration, so 6 hours captures the volatile post-graduation period for nearly every token.For tokens that keep trading past that window, switch to the standard subscriptions: when you receive a Migrated event, subscribe to the token with onTokenEventsCreated or onPriceUpdated for continuous coverage with no gap.onTokenEventsCreated and onPriceUpdated do not carry top10HoldersPercent or devHeldPercentage. Read those from filterTokens or onFilterTokensUpdated.

How do I monitor token graduations?

Subscribe to eventType: Migrated to receive events when tokens graduate from bonding curves to DEX pools. This is the recommended approach over Completed events.

What do sniperCount, bundlerCount, and insiderCount indicate?

All three are labels applied per token to wallets that bought or received it around launch, and each count is the number of labelled wallets that still hold the token. sniperCount is wallets that bought within the first 5 seconds of trading. bundlerCount is wallets that were part of a group of 4 or more buying in the same block on the launchpad pool before graduation. insiderCount is wallets with a provable link to the creator, such as being funded by or receiving tokens directly from the creator wallet. suspiciousCount is the deduplicated union of the three. The matching *HeldPercentage fields report the share of total supply those wallets hold now, so all of these numbers fall as the wallets sell. The full rules are in Discover tokens.

Created events have a 3-4s delay. Is there a faster way to see newly launched tokens?

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

API Documentation

Queries

Mutations

Subscriptions

Types

onLaunchpadTokenEventBatch

Returns

Arguments

Example

Usage Guidelines

Troubleshooting Tips

​Returns

​Arguments

​Example

​Usage Guidelines

​Troubleshooting Tips

​Related Recipes

Returns

Arguments

Example

Usage Guidelines

Troubleshooting Tips

Related Recipes