Skip to main content
POST
Returns ranked boards of launchpad tokens for the requested chains and columns. Each column is ranked and filtered independently and returns its full ranked set.

Columns

Each column represents one stage of a token’s launchpad lifecycle; see launchpad terms.

Request body

The body must name at least one chain and at least one column. A repeated chain slug is counted once, and every column ranks tokens from all the named chains as one set. Omit a column to skip it, or send {} to use its defaults. Inside a column, sortBy is the field to rank on, order is desc or asc, limit is clamped to 1–100 rather than rejected, and filters adds conditions on top of the column defaults.

Column defaults

Every column applies its own conditions in addition to request filters:
  • Every column excludes tokens with no update in the last 24 hours.
  • graduating and graduated keep only tokens with at least 10 holders, $1,000 of liquidity and a $5,000 market cap.
  • graduating also excludes tokens with no update in the last 60 minutes, unless they are at 99.5% or more of their bonding curve.
Request filters can tighten these conditions but not loosen them. For example, a holderCount minimum below 10 on graduated is raised to 10, and a maxGraduationStaleMinutes above 60 on graduating is lowered to 60.

Sort fields

Tokens with equal values are returned in a stable order.

Filters

A token must match every filter in the request, as well as the column defaults. The schema below lists each filter, and the following rules apply to all of them.
An unknown filter name returns 400 VALIDATION_ERROR. The sort field is holdersCount, but the filter is holderCount.
  • Ranges are { "min": …, "max": … }. Both bounds are inclusive, and either can be left out. A min above max returns 400 VALIDATION_ERROR. Each bound takes the type the schema gives its field: decimal strings for USD and native values and for bundlerSupplyPercent and insiderSupplyPercent, numbers for counts and the other percentages.
  • Lists are unions: a token passes when it matches any entry. symbolOrName and excludeSymbolOrName match the symbol or the name, ignoring case, and a word that looks like an address matches the token’s address exactly instead.
  • withAtLeastOneSocial includes only tokens with at least one social link; false applies no condition.
  • dexPaid includes tokens with a paid DexScreener profile when true, and tokens without one when false.
  • excludeAnnotations excludes tokens with any of the listed annotations, each written as { "kind": "mayhem_mode" }. An unknown kind returns 400 VALIDATION_ERROR.
  • Time limits are lastActivityMinutes, which includes tokens updated within that many minutes, and maxGraduationStaleMinutes, which excludes tokens with no update within that many minutes unless they are at 99.5% or more of their bonding curve. maxGraduationStaleMinutes applies to any column, and graduating caps it at 60. An update is any change to a token’s record, such as a trade, not only bonding-curve progress.
twitterReuseCount is accepted but not yet applied, so every token passes it.

Response

The response is a list with one entry per requested column, in the order newPairs, graduating, graduated. Each entry’s deltas is the full ranked column, with one item per rank starting from 1. Each item’s data is the token object that Tokens returns, without decimals and supply. Fields that the boards do not use, such as pools, ath, security.mintDisabled and most window stats, are sent with their zero, false, null or empty value. Read Tokens for the full token.

Errors

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Body

application/json

A discovery request: one or more chains, up to three columns.

chains
enum<string>[]
required

Chains every column ranks over, as one mixed set.

Chain slug. One spelling per chain, in paths and bodies alike. Only a chain with spot data is published.

Available options:
solana,
bsc,
robinhood,
elysium,
ethereum
graduated
null | object

Graduated column; omitted means not requested.

graduating
null | object

Graduating column; omitted means not requested.

newPairs
null | object

New-pairs column; omitted means not requested.

Response

One snapshot per requested column, in page order.

column
enum<string>
required

Column these deltas apply to.

Available options:
newPairs,
graduating,
graduated
deltas
object[]
required

The rows to apply in order: the whole column at first, then only the rows that changed.