# Token lists

> Lists: new, bonding, graduating, graduated, trending, top_volume, top_gainers, top_losers, top_market_cap (tokens traded in the last 30 days by market cap;…

Source: https://docs.crius.sh/reference/discovery/token-lists/ · Updated 2026-10-28

GET https://api.crius.sh/v1/{chain}/tokens

Lists: `new`, `bonding`, `graduating`, `graduated`, `trending`, `top_volume`, `top_gainers`, `top_losers`, `top_market_cap` (tokens traded in the last 30 days by market cap; prices from thin markets don't rank). Filter by `launchpad`, `quote`, `min_liquidity_usd`, `min_volume_usd`, `min_market_cap_usd` / `max_market_cap_usd` (e.g. `min_market_cap_usd=100000`) and `created_after_ts`; `window` picks the stats window. Up to 100 per page.

`trending` only lists clean tokens: no crash (price under 90% below its peak in the window), $1,000+ liquidity, real holders (20+, and at least 10% of the window's traders), no insider or wallet-farm launch, no bot distribution, no single wallet holding 40%+ of the liquidity unlocked. `clean=true` applies the same checks to any other list, e.g. `list=top_volume&clean=true` for volume leaders without rugs or wash trading.

> trending ranks real demand: a token needs a price less than 90% below its peak in the window (rugs drop out), $1,000+ liquidity, 20+ holders, and holders at least 10% of the window's traders (wash trading spreads volume over wallets that don't keep the token), no insider launch (one wallet sniping 50%+ of supply in the first 10 blocks, or a wallet farm holding the supply), no bot distribution (25+ of the top 100 holders with near-identical balances), and no single wallet holding 40%+ of the liquidity unlocked (it could pull the market); see /security launch.

## Path parameters

`chain`stringrequired

Chain slug (`robinhood`) or chain id (`4663`).

## Query parameters

`list`string Default `trending`

Which list to return. One of `new`, `bonding`, `graduating`, `graduated`, `trending`, `top_volume`, `top_gainers`, `top_losers`, `top_market_cap`.

`window`string

Stats window. From `1s` to `24h`.

`launchpad`string

Launchpad id, such as `pons` or `flap` (see /launchpads).

`quote`string

Quote asset of the token's main pool. One of `eth`, `usdg`.

`min_liquidity_usd`number

Only tokens with at least this much liquidity (USD).

`min_volume_usd`number

Only tokens with at least this much volume in the window (USD).

`min_market_cap_usd`number

E.g. 100000.

`max_market_cap_usd`number

`created_after_ts`integer

Only tokens created after this time (unix ms).

`clean`boolean Default `false`

Trending's quality filters on any list (no rugs, wash trading or insider launches)

`limit`integer Default `50`

Maximum number of items to return.

`cursor`string

Pagination cursor from the previous response's `meta.next_cursor`.

## Guides that use this endpoint

[**Build a Robinhood Chain token screener**Build a Robinhood Chain token screener with the Crius API: clean token lists, batch profiles, a risk check per token, credits per refresh and working code.](https://docs.crius.sh/guides/build-a-token-screener/)[**Find new tokens on Robinhood Chain as they launch**List new Robinhood Chain tokens seconds after they are created, filter by launchpad, liquidity and creation time, with real responses from the Crius API.](https://docs.crius.sh/guides/find-new-tokens/)[**Get trending Robinhood Chain tokens (without rugs and wash trading)**Get the Robinhood Chain tokens with the most real traders, plus top gainers and volume leaders with rugs and wash trading filtered out. Real API responses.](https://docs.crius.sh/guides/find-trending-tokens/)[**Get new Robinhood Chain tokens and graduations in real time**Get new Robinhood Chain launchpad tokens, graduations and pools the moment they happen, with the Crius WebSocket and a Node.js client that checks each token.](https://docs.crius.sh/guides/stream-new-tokens/)[**Find Robinhood Chain tokens above a market cap**Rank Robinhood Chain tokens by market cap, filter by a minimum or a range, and drop fake market caps from dust pools and insider launches. Real responses.](https://docs.crius.sh/guides/find-tokens-by-market-cap/)[**Build a Robinhood Chain stats dashboard**Build a Robinhood Chain analytics dashboard with the Crius API: DEX volume, trades, TVL, launches, gas and volume history in your time zone, with code.](https://docs.crius.sh/guides/build-a-chain-stats-dashboard/)[**Track Robinhood Chain bonding-curve tokens about to graduate**Track Pons, Flap and other Robinhood Chain launchpad tokens on their bonding curves, see which are closest to graduating and catch each graduation.](https://docs.crius.sh/guides/track-bonding-and-graduating-tokens/)[**Get Robinhood Chain launchpad stats (launches, graduations, volume)**Launches, graduations, graduation rate, time to graduate, volume, traders and fees for every Robinhood Chain launchpad, with daily history. Real responses.](https://docs.crius.sh/guides/get-launchpad-stats/)[**Market cap, FDV and circulating supply of a Robinhood Chain token (token supply API)**Robinhood Chain token supply API: total, burned, locked and circulating supply plus market cap and FDV of any token in one call, and how each is computed.](https://docs.crius.sh/guides/market-cap-fdv-and-supply/)[**How to create a token on Robinhood Chain (launchpads compared)**The ways to create a token on Robinhood Chain: Pons, Flap.sh, Bankr, Long.xyz, Flywheel, King of the Markets or your own ERC-20, compared with real launch data.](https://docs.crius.sh/guides/create-a-token-on-robinhood-chain/)[**Robinhood Chain API for token screeners**Build a Robinhood Chain token screener with the Crius API: new, trending and graduating lists, batch profiles, candles and risk badges, with credit costs.](https://docs.crius.sh/use-cases/token-screeners/)[**Robinhood Chain API for trading bots**What a Robinhood Chain trading bot needs from the Crius API: new launches, live prices, pools and safety checks before every buy, with credit costs.](https://docs.crius.sh/use-cases/trading-bots/)

## Errors

Errors come back as `{ "error": { "code", "message" } }` with the matching HTTP status: `400` bad parameter, `401` missing or invalid key, `403` endpoint above your plan, `404` unknown token or address, `429` rate limit or credits used up (with `Retry-After`). See [Errors](https://docs.crius.sh/errors/).

## More discovery & search endpoints

[GET/searchSearchAnonymous · 1 cr](https://docs.crius.sh/reference/discovery/search/)

Request No key needed

  

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/tokens?list=trending&window=24h&limit=3" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/tokens?list=trending&window=24h&limit=3", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/tokens?list=trending&window=24h&limit=3",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

Response 200 · captured Oct 28, 2026

```json
{
  "data": [
    {
      "address": "0xd086f891229cd123aadfcae7c4b40150a80fd9d7",
      "buy_volume_usd": {
        "1h": 846676,
        "24h": 1760953,
        "5m": 213539,
        "6h": 1760953
      },
      "buyers": {
        "1h": 2862,
        "24h": 4951,
        "5m": 893,
        "6h": 4951
      },
      "buys": {
        "1h": 5160,
        "24h": 10660,
        "5m": 1143,
        "6h": 10660
      },
      "change_pct": {
        "1h": 219.677,
        "24h": 34319.8,
        "5m": 3.97796,
        "6h": 34319.8
      },
      "created_block": 100319502,
      "created_ts": 1793216058240,
      "decimals": 18,
      "fdv_usd": 2836574,
      "holders": 2857,
      "launchpad": null,
      "launchpad_name": null,
      "links": {
        "discord": null,
        "farcaster": null,
        "github": null,
        "telegram": null,
        "twitter": "https://x.com/search?q=0xd086f891229cd123aadfcae7c4b40150a80fd9d7&src=typed_query&f=live",
        "website": "https://xdcoinsol.lol"
      },
      "liquidity_usd": 723990,
      "logo": "https://api.crius.sh/v1/robinhood/logo/0xd086f891229cd123aadfcae7c4b40150a80fd9d7.png?size=128",
      "market_cap_usd": 2552917,
      "name": "Pizza",
      "price_eth": 0.00000120424,
      "price_usd": 0.00283657,
      "progress_pct": null,
      "quote": "USDG",
      "sell_volume_usd": {
        "1h": 706205,
        "24h": 1465984,
        "5m": 207484,
        "6h": 1465984
      },
      "sellers": {
        "1h": 1951,
        "24h": 3642,
        "5m": 630,
        "6h": 3642
      },
      "sells": {
        "1h": 7995,
        "24h": 17196,
        "5m": 1833,
        "6h": 17196
      },
      "status": null,
      "symbol": "PIZZA",
      "traders": {
        "1h": 3401,
        "24h": 5197,
        "5m": 1288,
        "6h": 5197
      },
      "txns": {
        "1h": 8316,
        "24h": 17544,
        "5m": 1915,
        "6h": 17544
      },
      "volume_usd": {
        "1h": 1552881,
        "24h": 3226937,
        "5m": 421023,
        "6h": 3226937
      }
    },
    {
      "address": "0x2e8c31162b855a2ffa90f6f8634643ad6f111e18",
      "buy_volume_usd": {
        "1h": 68152.3,
        "24h": 3574310,
        "5m": 1310.32,
        "6h": 2375164
      },
      "buyers": {
        "1h": 168,
        "24h": 2815,
        "5m": 15,
        "6h": 1546
      },
      "buys": {
        "1h": 369,
        "24h": 11920,
        "5m": 17,
        "6h": 5582
      },
      "change_pct": {
        "1h": 0.783146,
        "24h": 25.2392,
        "5m": -1.01199,
        "6h": 21.3351
      },
      "created_block": 9721433,
      "created_ts": 1784051310300,
      "decimals": 18,
      "fdv_usd": 80269321,
      "holders": 58015,
      "launchpad": "long",
      "launchpad_name": "Long.xyz",
      "links": {
        "discord": null,
        "farcaster": null,
        "github": null,
        "telegram": null,
        "twitter": "https://x.com/artificiallyinu",
        "website": "https://artificialinu.com/"
      },
      "liquidity_usd": 4181412,
      "logo": "https://api.crius.sh/v1/robinhood/logo/0x2e8c31162b855a2ffa90f6f8634643ad6f111e18.png?size=128",
      "market_cap_usd": 80102641,
      "name": "Artificial Inu",
      "price_eth": 0.0000343898,
      "price_usd": 0.0810048,
      "progress_pct": null,
      "quote": "PONS",
      "sell_volume_usd": {
        "1h": 50026.5,
        "24h": 3026550,
        "5m": 4390.97,
        "6h": 1840520
      },
      "sellers": {
        "1h": 151,
        "24h": 3051,
        "5m": 15,
        "6h": 1664
      },
      "sells": {
        "1h": 287,
        "24h": 12095,
        "5m": 20,
        "6h": 5933
      },
      "status": "launched",
      "symbol": "AI",
      "traders": {
        "1h": 272,
        "24h": 4132,
        "5m": 27,
        "6h": 2294
      },
      "txns": {
        "1h": 454,
        "24h": 14552,
        "5m": 28,
        "6h": 6627
      },
      "volume_usd": {
        "1h": 118179,
        "24h": 6600860,
        "5m": 5701.29,
        "6h": 4215684
      }
    },
    {
      "address": "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec",
      "buy_volume_usd": {
        "1h": 305614,
        "24h": 5466111,
        "5m": 20057.3,
        "6h": 2772574
      },
      "buyers": {
        "1h": 229,
        "24h": 1996,
        "5m": 56,
        "6h": 790
      },
      "buys": {
        "1h": 847,
        "24h": 16482,
        "5m": 104,
        "6h": 6874
      },
      "change_pct": {
        "1h": 0.3314,
        "24h": -1.40466,
        "5m": -0.235953,
        "6h": -1.21643
      },
      "created_block": 153563,
      "created_ts": 1782222069300,
      "decimals": 18,
      "fdv_usd": 18876187,
      "holders": 192283,
      "launchpad": null,
      "launchpad_name": null,
      "links": {
        "discord": null,
        "farcaster": null,
        "github": null,
        "telegram": null,
        "twitter": null,
        "website": null
      },
      "liquidity_usd": 5815054,
      "logo": null,
      "market_cap_usd": 18876064,
      "name": "NVIDIA • Robinhood Token",
      "price_eth": 0.0911626,
      "price_usd": 214.732,
      "progress_pct": null,
      "quote": "USDG",
      "sell_volume_usd": {
        "1h": 159139,
        "24h": 6030012,
        "5m": 54077.9,
        "6h": 3340517
      },
      "sellers": {
        "1h": 224,
        "24h": 2645,
        "5m": 57,
        "6h": 1101
      },
      "sells": {
        "1h": 678,
        "24h": 18554,
        "5m": 151,
        "6h": 8629
      },
      "status": null,
      "symbol": "NVDA",
      "traders": {
        "1h": 325,
        "24h": 3519,
        "5m": 83,
        "6h": 1422
      },
      "txns": {
        "1h": 1413,
        "24h": 32946,
        "5m": 240,
        "6h": 14457
      },
      "volume_usd": {
        "1h": 464753,
        "24h": 11496124,
        "5m": 74135.1,
        "6h": 6113091
      }
    }
  ],
  "meta": {
    "block": 100406892,
    "block_age_ms": 1238,
    "block_ts": 1793225087000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 117,
    "list": "trending",
    "next_cursor": "3",
    "safe_block": 100401329,
    "stats_since": "chain_start",
    "window": "24h"
  }
}
```

[Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Ftokens&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fdiscovery%2Ftoken-lists%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)