Discovery boards

curl -X POST "https://api.metastreams.io/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.metastreams.io/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();

{
  "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

discovery

curl -X POST "https://api.metastreams.io/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.metastreams.io/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();

{
  "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
          }
        }
      ]
    }
  ]
}

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.

Columns

Each column is one stage of a token’s launchpad life; see launchpad terms.

Column	Holds	Default ranking
`newPairs`	Launchpad tokens below 40% of their bonding curve	`createdAt`, newest first
`graduating`	Launchpad tokens at 40% of their curve or more, not yet graduated	`bondingCurveActivity`, highest first
`graduated`	Launchpad tokens that have graduated, or that have no curve reading	`graduatedAt`, newest first

Body

Name at least one chain and at least one column. A repeated chain slug is read once, and every column ranks tokens from all the named chains as one set. Leave a column out to skip it, and send {} to take its defaults. Inside a column, sortBy names the field to rank on, order is desc or asc, a limit outside 1 to 100 is moved into that range rather than refused, and filters adds conditions on top of the column defaults.

Column defaults

Every column applies conditions of its own, on top of your filters:

Every column leaves out 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 leaves out tokens with no update in the last 60 minutes, unless they are at 99.5% of their curve or more.

Your filters can tighten these conditions but not loosen them. A holderCount minimum below 10 on graduated, for example, is raised to 10, and a maxGraduationStaleMinutes above 60 on graduating is lowered to 60.

Sort fields

`sortBy`	Ranks on
`createdAt`	Token creation time
`volume24hUsd`	USD volume over the last 24 hours
`marketCapUsd`	USD market cap
`liquidityUsd`	USD liquidity
`holdersCount`	Current holders
`tradeCount24h`	Buys plus sells over the last 24 hours
`bondingCurvePct`	Bonding-curve completion. On `graduating`, this ranks on `bondingCurveActivity` instead.
`bondingCurveActivity`	Curve completion weighted by the last hour’s volume: `bondingCurvePct` multiplied by `ln(1 + stats["1h"].volume.usd)`
`graduatedAt`	Graduation time

Tokens with equal values keep a fixed order.

Filters

A token must meet every filter you send, as well as the column defaults. The schema below names each filter; these rules hold across all of them.

The API ignores a filter name it does not know, rather than refusing it. Check spellings: 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 of the field it bounds: decimal strings for USD values, numbers for counts and 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 keeps tokens that carry at least one social link. It is the only switch, and false applies no condition.
Time limits are lastActivityMinutes, which keeps tokens updated within that many minutes, and maxGraduationStaleMinutes, which drops tokens with no update within that many minutes unless they are at 99.5% of their curve or more. maxGraduationStaleMinutes applies on any column, and graduating caps it at 60. An update is any change to a token’s record, such as a trade, not only curve progress.

twitterReuseCount is accepted but not yet applied: every token passes it.

Response

columns holds one entry per requested column, in the order newPairs, graduating, graduated. Each entry’s deltas is the whole ranked column, one item per rank from 1, and each item’s data is the same token object Token details returns.

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.metastreams.io/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.metastreams.io/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();

{
  "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
          }
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Send the API key as Authorization: Bearer <key>.

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,

base,

bsc,

robinhood,

arc

graduated

null | object

Graduated column; omitted means not requested.

Show child attributes

graduating

null | object

Graduating column; omitted means not requested.

Show child attributes

newPairs

null | object

New-pairs column; omitted means not requested.

Show child attributes

Response

One snapshot per requested column, in page order.

POST /v1/discovery response: one snapshot per requested column, in page order.

columns

object[]

required

The requested columns' snapshots.

Show child attributes

REST

Streams

Columns

Body

Column defaults

Sort fields

Filters

Response

Errors

Authorizations

Body

Response

​Columns

​Body

​Column defaults

​Sort fields

​Filters

​Response

​Errors

Authorizations

Body

Response

Columns

Body

Column defaults

Sort fields

Filters

Response

Errors