onLaunchpadTokenEvent

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

OnLaunchpadTokenEventInput

See OnLaunchpadTokenEventInput

Show Properties

LaunchpadTokenProtocol

The launchpad protocol. See LaunchpadTokenProtocol

[LaunchpadTokenProtocol!]

A list of launchpad protocols. See LaunchpadTokenProtocol

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, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun, Launchfair.

[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, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun, Launchfair.

LaunchpadTokenEventType

The type of event. See LaunchpadTokenEventType

String

The contract address of the token. Requires networkId.

Int

The network ID that the token is deployed on.

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. We recommend updating your integration to listen for migrated events to ensure reliable graduation monitoring.

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 {
  onLaunchpadTokenEvent(
    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
      }
    }
  }
}

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). This window captures the volatile post-graduation period where most launchpad token activity occurs, without duplicating data available from the standard subscriptions
To follow a token beyond the 6-hour window, hand off when you see the Migrated event: subscribe to the token with onTokenEventsCreated or onPriceUpdated for continuous coverage with no gap
For high-throughput use cases monitoring many tokens, prefer onLaunchpadTokenEventBatch, which batches multiple events per message

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

onLaunchpadTokenEvent

Returns

Arguments

Example

Usage Guidelines

​Returns

​Arguments

​Example

​Usage Guidelines

​Related Recipes

Returns

Arguments

Example

Usage Guidelines

Related Recipes