Discovery boards

curl -X POST "https://{{API_HOST}}/v1/discovery" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chains": ["solana", "base"],
    "graduating": {
      "sortBy": "volume24hUsd",
      "limit": 20,
      "filters": { "liquidityUsd": { "min": "20000" }, "holderCount": { "min": 500 } }
    }
  }'

const response = await fetch("https://{{API_HOST}}/v1/discovery", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    chains: ["solana", "base"],
    graduating: { sortBy: "volume24hUsd", limit: 20 },
  }),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { columns } = await response.json();

use serde_json::{Value, json};

let boards: Value = reqwest::Client::new()
    .post("https://{{API_HOST}}/v1/discovery")
    .bearer_auth(std::env::var("API_KEY")?)
    .json(&json!({
        "chains": ["solana", "base"],
        "graduating": { "sortBy": "volume24hUsd", "limit": 20 },
    }))
    .send()
    .await?
    .error_for_status()?
    .json()
    .await?;

for column in boards["columns"].as_array().into_iter().flatten() {
    println!("{} {}", column["column"], column["deltas"].as_array().map_or(0, Vec::len));
}

{
  "columns": [
    {
      "column": "graduating",
      "deltas": [
        {
          "chain": "solana",
          "address": "TokenMint1111111111111111111111111111111pump",
          "rank": 1,
          "data": {
            "chain": "solana",
            "address": "TokenMint1111111111111111111111111111111pump",
            "name": "Example",
            "symbol": "EXAMPLE",
            "decimals": 6,
            "price": { "native": "0.00000042", "usd": "0.000075" },
            "marketCap": { "native": "420.5", "usd": "75000" },
            "liquidity": { "native": "128.4", "usd": "22900" },
            "bondingCurvePct": "91.4",
            "updatedAt": 1789632012345
          }
        }
      ]
    }
  ]
}

curl -X POST "https://{{API_HOST}}/v1/discovery" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chains": ["solana", "base"],
    "graduating": {
      "sortBy": "volume24hUsd",
      "limit": 20,
      "filters": { "liquidityUsd": { "min": "20000" }, "holderCount": { "min": 500 } }
    }
  }'

const response = await fetch("https://{{API_HOST}}/v1/discovery", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    chains: ["solana", "base"],
    graduating: { sortBy: "volume24hUsd", limit: 20 },
  }),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { columns } = await response.json();

use serde_json::{Value, json};

let boards: Value = reqwest::Client::new()
    .post("https://{{API_HOST}}/v1/discovery")
    .bearer_auth(std::env::var("API_KEY")?)
    .json(&json!({
        "chains": ["solana", "base"],
        "graduating": { "sortBy": "volume24hUsd", "limit": 20 },
    }))
    .send()
    .await?
    .error_for_status()?
    .json()
    .await?;

for column in boards["columns"].as_array().into_iter().flatten() {
    println!("{} {}", column["column"], column["deltas"].as_array().map_or(0, Vec::len));
}

{
  "columns": [
    {
      "column": "graduating",
      "deltas": [
        {
          "chain": "solana",
          "address": "TokenMint1111111111111111111111111111111pump",
          "rank": 1,
          "data": {
            "chain": "solana",
            "address": "TokenMint1111111111111111111111111111111pump",
            "name": "Example",
            "symbol": "EXAMPLE",
            "decimals": 6,
            "price": { "native": "0.00000042", "usd": "0.000075" },
            "marketCap": { "native": "420.5", "usd": "75000" },
            "liquidity": { "native": "128.4", "usd": "22900" },
            "bondingCurvePct": "91.4",
            "updatedAt": 1789632012345
          }
        }
      ]
    }
  ]
}

POST /v1/discovery

One request names the chains and the columns it wants. Each column is ranked and filtered on its own, and answers with its whole ranked set. Filtering and sorting covers the ranking fields, the column defaults and every filter.

Body

string[]

required

One or more chain slugs. Each column ranks tokens from all of them as one set. A repeated slug is read once.

object

Launchpad tokens below 40% of their bonding curve. Send {} for the defaults.

object

Launchpad tokens at 40% of their curve or more, not yet graduated.

object

Launchpad tokens that have graduated, or that have no curve reading.

Leave a column out to skip it, and name at least one.

Column config

string

The field to rank on. The column’s default when absent.

string

default:"desc"

desc or asc.

integer

default:"20"

Tokens in the column. A value outside 1–100 is clamped, not refused.

object

Conditions every token in the column must meet, on top of the column defaults. An unknown filter name is ignored rather than refused.

Response

object[]

required

One entry per requested column, in the order newPairs, graduating, graduated.

Show column

string

required

Which column these entries rank: newPairs, graduating or graduated.

object[]

required

The whole ranked column, one entry per rank.

Show entry

string

required

The chain slug. With address, it keys the row.

string

required

The token’s address.

integer

required

The token’s place in the column, from 1.

object

required

The token object.

Token object

Each entry’s data is the same object Token details returns.

string

required

The chain slug the token trades on.

string

required

The token’s address.

string

required

The token’s name.

string

required

The token’s symbol.

integer

required

The token’s decimals.

decimal string

required

Total supply.

string

required

The creator’s address.

object

required

The creator wallet’s first inbound funding.

Show devFunding

string

required

unresolved while the lookup can still resolve, or resolved once it has settled. The other fields are null in both states when no funder is known.

string | null

The funder’s address.

string | null

cex for a known exchange, or wallet for another wallet.

string | null

A display label for the funder, such as an exchange name.

integer

required

When the token was created, in milliseconds.

string | null

required

The launchpad the token launched on. null for tokens that did not launch on one.

decimal string | null

required

Bonding-curve completion, 0–100. null for tokens not on a bonding curve.

integer | null

required

When the token left its launchpad, in milliseconds. null until then.

string | null

required

The pool the token moved to on graduation.

string | null

required

The venue that pool trades on.

string[]

required

The venues the token’s top pools trade on, deepest pool first.

string | null

required

The address of the quote asset in the token’s deepest pool.

string | null

required

The symbol of that quote asset.

money object

required

The current price.

money object

required

The current market cap.

money object

required

The current liquidity.

object

required

All-time highs.

Show ath

money object

required

The all-time-high price.

integer

required

When that price was set, in milliseconds.

money object

required

The all-time-high market cap.

integer

required

When that market cap was set, in milliseconds.

object

required

Trade activity over trailing windows that end now, keyed 5m, 30m, 1h, 6h and 24h.

Show stats window

decimal string

required

Price change over the window, as a signed percentage.

money object

required

Trade volume over the window.

integer

required

Buy trades over the window.

integer

required

Sell trades over the window.

money object

required

Buy-side volume over the window.

money object

required

Sell-side volume over the window.

object

required

All-time totals.

Show totals

money object

required

All-time trade volume.

object

required

Fee totals by kind: transaction, validator, platform and dex, each a money object. The kinds are measured on different bases, so do not add them together.

object

required

Holder concentration and wallet risk groups. Each Pct field is the share of supply a group holds now, 0–100. Each Count field is the number of wallets that ever carried the group’s flag on this token, so it never decreases.

Show holders

integer

required

Current holders.

decimal string

required

Share held by the 10 largest holders. It can read above 100 when supply data drifts.

decimal string

required

Share held by the creator.

decimal string, integer

required

Share held by, and count of, wallets that bought within two blocks of the token’s first pool (snipers).

decimal string, integer

required

Share held by, and count of, wallets that made the fourth or later buy in a single block (bundlers).

decimal string, integer

required

Share held by, and count of, wallets that bought within three blocks of the token’s first pool (insiders). These overlap with snipers.

decimal string, integer

required

Share held by, and count of, wallets funded less than seven days before they traded.

decimal string, integer

required

Share held by, and count of, wallets that have traded through a known trading terminal.

decimal string, integer

required

Share held by, and count of, wallets that have traded through the fomo.family terminal.

decimal string

required

Share held by wallets a security source labels malicious.

integer

required

Wallets that ever traded the token while labelled malicious.

decimal string

required

Share of current holders that a known exchange funded, 0–100.

object

required

Contract security signals.

Show security

boolean

required

true when no more of the token can be minted: the mint authority is revoked on Solana, or the contract holds no mint power on EVM chains.

boolean

required

true when transfers can be blocked: by a freeze authority on Solana, or by a blacklist or pause on EVM chains.

decimal string | null

required

Share of liquidity burnt or locked, 0–100. null until observed.

integer | null

required

The contract’s transfer fee in basis points; 250 is 2.50%. null when the contract has not been scored.

decimal string

required

Not yet populated; always "0".

object

required

Project links and description. Every field except twitterReuseCount can be null.

Show metadata

string | null

required

string | null

required

string | null

required

string | null

required

string | null

required

integer

required

Not yet populated; always 0.

object[]

External listings. Left out when empty. Today the only listing is a paid DexScreener profile: {"platform": "dexScreener", "isPaid": true, "paidAt": 1789000000000}. paidAt can be null.

object[]

Flags the launch carried, each tagged by kind, such as {"kind": "mayhem_mode"}. Left out when empty. New kinds can appear.

integer

required

When the token object last changed, in milliseconds.

Errors

Code	When
`UNSUPPORTED_CHAIN`	A slug in `chains` is not supported
`VALIDATION_ERROR`	No chain or no column requested, a range whose `min` is above its `max`, or a malformed body

curl -X POST "https://{{API_HOST}}/v1/discovery" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chains": ["solana", "base"],
    "graduating": {
      "sortBy": "volume24hUsd",
      "limit": 20,
      "filters": { "liquidityUsd": { "min": "20000" }, "holderCount": { "min": 500 } }
    }
  }'

const response = await fetch("https://{{API_HOST}}/v1/discovery", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    chains: ["solana", "base"],
    graduating: { sortBy: "volume24hUsd", limit: 20 },
  }),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { columns } = await response.json();

use serde_json::{Value, json};

let boards: Value = reqwest::Client::new()
    .post("https://{{API_HOST}}/v1/discovery")
    .bearer_auth(std::env::var("API_KEY")?)
    .json(&json!({
        "chains": ["solana", "base"],
        "graduating": { "sortBy": "volume24hUsd", "limit": 20 },
    }))
    .send()
    .await?
    .error_for_status()?
    .json()
    .await?;

for column in boards["columns"].as_array().into_iter().flatten() {
    println!("{} {}", column["column"], column["deltas"].as_array().map_or(0, Vec::len));
}

{
  "columns": [
    {
      "column": "graduating",
      "deltas": [
        {
          "chain": "solana",
          "address": "TokenMint1111111111111111111111111111111pump",
          "rank": 1,
          "data": {
            "chain": "solana",
            "address": "TokenMint1111111111111111111111111111111pump",
            "name": "Example",
            "symbol": "EXAMPLE",
            "decimals": 6,
            "price": { "native": "0.00000042", "usd": "0.000075" },
            "marketCap": { "native": "420.5", "usd": "75000" },
            "liquidity": { "native": "128.4", "usd": "22900" },
            "bondingCurvePct": "91.4",
            "updatedAt": 1789632012345
          }
        }
      ]
    }
  ]
}

REST

Streams

Body

Column config

Response

Token object

Errors

​Body

​Column config

​Response

​Token object

​Errors

Body

Column config

Response

Token object

Errors