Launchpads - Codex

In this recipe we’ll show you how to use the Codex api to create a 3 column launchpad view, complete with filtering, sorting, and realtime updates. This data directly powers the launchpads view on defined.fi. The websocket pushes data on every new token creation and event through the lifetime of the bonding curve and for an additional 6 hours post-migration (graduation).

New to launchpad tokens? See the Launchpad Lifecycle guide for how tokens progress through stages — from bonding curve to graduation to migration.

The supported launchpads include Pump.fun, Four.meme, Launchlab, Meteora, and more. See Supported Launchpads for the complete list with each launchpad’s launchpadName and protocol filter values.

It is a requirement to proxy launchpad data through your backend to serve multiple users from a single subscription. Failure to do so may result in additional charges and termination of your connection.

Initial Fetch

Start by implementing the following query to fetch the launchpad data, one query for each column.

New

Test this query in the Explorer →

query LaunchpadsNew {
  filterTokens(
    filters: { launchpadCompleted: false, launchpadMigrated: false }
    rankings: { attribute: createdAt, direction: DESC }
  ) {
    results {
      createdAt
      marketCap
      priceUSD
      token {
        name
        symbol
        address
        networkId
        launchpad {
          graduationPercent
          launchpadName
          launchpadProtocol
          migrated
          completed
          completedAt
        }
      }
    }
  }
}

Completing

Test this query in the Explorer →

query LaunchpadsCompleting {
  filterTokens(
    filters: {
      launchpadCompleted: false
      launchpadMigrated: false
      launchpadGraduationPercent: { gt: 80, lt: 100 }
    }
    rankings: { attribute: graduationPercent, direction: DESC }
  ) {
    results {
      createdAt
      marketCap
      priceUSD
      token {
        name
        symbol
        address
        networkId
        launchpad {
          graduationPercent
          launchpadName
          launchpadProtocol
          migrated
          completed
          completedAt
        }
      }
    }
  }
}

Completed

Test this query in the Explorer →

query LaunchpadsCompleted {
  filterTokens(
    filters: {
      launchpadMigrated: true
      launchpadGraduationPercent: { gte: 100 }
    }
    rankings: { attribute: launchpadMigratedAt, direction: DESC }
  ) {
    results {
      createdAt
      marketCap
      priceUSD
      token {
        name
        symbol
        address
        networkId
        launchpad {
          graduationPercent
          launchpadName
          launchpadProtocol
          migrated
          completed
          completedAt
        }
      }
    }
  }
}

Now you have the data for the initial render for each column. You can adjust the filters with the remaining of the arguments to the filterTokens query. See the TokenFilters type for more details.

By default filterTokens will return all tokens from a launchpad, across all networks, if you want to scope down to a specific launchpad, use the launchpadName or launchpadProtocol filters, if you want to narrow down just to specific network, use the network filter.

Realtime Updates

To get realtime updates, you can use the onLaunchpadTokenEventBatch subscription. This gives you every update for each launchpad token. Test this query in the Explorer →

subscription OnLaunchpadTokenEventBatch(
  $input: OnLaunchpadTokenEventBatchInput
) {
  onLaunchpadTokenEventBatch(input: $input) {
    eventType
    marketCap
    price
    token {
      address
      decimals
      id
      name
      networkId
      symbol
      createdAt
      launchpad {
        graduationPercent
        poolAddress
        completedAt
        completed
        migratedAt
        migrated
        migratedPoolAddress
      }
    }
    devWallet {
      address
      displayName
      category
      tokensCreatedCount
      tokensMigratedCount
    }
  }
}

Now you’ve got all you need to build a fully functional launchpad view.

Each launchpad event carries devWallet, the token creator resolved to a full Wallet. Select it to show the dev’s display name, category, identity labels, and how many tokens they’ve created and migrated — inline, without a separate lookup per launch.

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.

​Initial Fetch

​Realtime Updates

​Further Reading

Initial Fetch

Realtime Updates

Further Reading