> ## Documentation Index > Fetch the complete documentation index at: https://docs.metastreams.dev/llms.txt > Use this file to discover all available pages before exploring further. # Discovery boards > Rank launchpad tokens by launch stage, across one or more chains, in a single request. ```http theme={null} 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](/concepts/filtering#discovery-boards) covers the ranking fields, the column defaults and every filter. ## Body One or more [chain slugs](/concepts/chains). Each column ranks tokens from all of them as one set. A repeated slug is read once. Launchpad tokens below 40% of their bonding curve. Send `{}` for the defaults. Launchpad tokens at 40% of their curve or more, not yet graduated. 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 The [field to rank on](/concepts/filtering#sort-fields). The column's default when absent. `desc` or `asc`. Tokens in the column. A value outside 1–100 is clamped, not refused. Conditions every token in the column must meet, on top of the [column defaults](/concepts/filtering#column-defaults). An unknown filter name is ignored rather than refused. ## Response One entry per requested column, in the order `newPairs`, `graduating`, `graduated`. Which column these entries rank: `newPairs`, `graduating` or `graduated`. The whole ranked column, one entry per rank. The [chain slug](/concepts/chains). With `address`, it keys the row. The token's address. The token's place in the column, from 1. The token object. ### Token object Each entry's `data` is the same object [Token details](/reference/rest/token-details) returns. The [chain slug](/concepts/chains) the token trades on. The token's address. The token's name. The token's symbol. The token's decimals. Total supply. The creator's address. The creator wallet's first inbound funding. `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. The funder's address. `cex` for a known exchange, or `wallet` for another wallet. A display label for the funder, such as an exchange name. When the token was created, in milliseconds. The launchpad the token launched on. `null` for tokens that did not launch on one. Bonding-curve completion, 0–100. `null` for tokens not on a bonding curve. When the token left its launchpad, in milliseconds. `null` until then. The pool the token moved to on graduation. The venue that pool trades on. The venues the token's top pools trade on, deepest pool first. The address of the quote asset in the token's deepest pool. The symbol of that quote asset. The current price. The current market cap. The current liquidity. All-time highs. The all-time-high price. When that price was set, in milliseconds. The all-time-high market cap. When that market cap was set, in milliseconds. Trade activity over trailing windows that end now, keyed `5m`, `30m`, `1h`, `6h` and `24h`. Price change over the window, as a signed percentage. Trade volume over the window. Buy trades over the window. Sell trades over the window. Buy-side volume over the window. Sell-side volume over the window. All-time totals. All-time trade volume. 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. 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. Current holders. Share held by the 10 largest holders. It can read above 100 when supply data drifts. Share held by the creator. Share held by, and count of, wallets that bought within two blocks of the token's first pool (snipers). Share held by, and count of, wallets that made the fourth or later buy in a single block (bundlers). Share held by, and count of, wallets that bought within three blocks of the token's first pool (insiders). These overlap with snipers. Share held by, and count of, wallets funded less than seven days before they traded. Share held by, and count of, wallets that have traded through a known trading terminal. Share held by, and count of, wallets that have traded through the fomo.family terminal. Share held by wallets a security source labels malicious. Wallets that ever traded the token while labelled malicious. Share of current holders that a known exchange funded, 0–100. Contract security signals. `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. `true` when transfers can be blocked: by a freeze authority on Solana, or by a blacklist or pause on EVM chains. Share of liquidity burnt or locked, 0–100. `null` until observed. The contract's transfer fee in basis points; `250` is 2.50%. `null` when the contract has not been scored. Not yet populated; always `"0"`. Project links and description. Every field except `twitterReuseCount` can be `null`. Not yet populated; always `0`. 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`. Flags the launch carried, each tagged by `kind`, such as `{"kind": "mayhem_mode"}`. Left out when empty. New kinds can appear. 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 | ```bash cURL theme={null} 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 } } } }' ``` ```typescript TypeScript theme={null} 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(); ``` ```rust Rust theme={null} 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)); } ``` ```json Shortened theme={null} { "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 } } ] } ] } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.