Discovery & search

Find tokens: curated lists with filters, and a fast search box backend.

Endpoint	Method	Plan	Credits
Token lists	`GET /v1/{chain}/tokens`	Anonymous	1
Search	`GET /v1/{chain}/search`	Anonymous	1

Token lists

GET /v1/{chain}/tokens

Plan: Anonymous and above (no key needed) · Cost: 1 credit per call

Lists: new, bonding, graduating, graduated, trending, top_volume, top_gainers, top_losers. Filter by launchpad, quote, min_liquidity_usd, min_volume_usd and created_after_ts; window picks the stats window. Up to 100 per page.

Parameters

Name	In	Type	Default	Description
`chain`	path, required	string		Chain slug (`robinhood`) or chain id (`4663`).
`list`	query	string	`trending`	Which list to return. One of `new`, `bonding`, `graduating`, `graduated`, `trending`, `top_volume`, `top_gainers`, `top_losers`.
`window`	query	string		Stats window. From `1s` to `24h`.
`launchpad`	query	string		Launchpad id, such as `pons` or `flap` (see /launchpads).
`quote`	query	string		Quote asset of the token’s main pool. One of `eth`, `usdg`.
`min_liquidity_usd`	query	number		Only tokens with at least this much liquidity (USD).
`min_volume_usd`	query	number		Only tokens with at least this much volume in the window (USD).
`created_after_ts`	query	integer		Only tokens created after this time (unix ms).
`limit`	query	integer	`50`	Maximum number of items to return.
`cursor`	query	string		Pagination cursor from the previous response’s `meta.next_cursor`.

Request

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

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();

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"])

Try it in the playground →

Example response

Real response captured from the API (arrays trimmed to three items).

{
  "data": [
    {
      "address": "0xc9675fe679c7d4e1b94416f66d61c96127eb964a",
      "buy_volume_usd": {
        "1h": 21463,
        "24h": 653991,
        "5m": 2331.27,
        "6h": 164734
      },
      "buyers": {
        "1h": 212,
        "24h": 4198,
        "5m": 33,
        "6h": 1218
      },
      "buys": {
        "1h": 368,
        "24h": 10533,
        "5m": 39,
        "6h": 2645
      },
      "change_pct": {
        "1h": -4.93203,
        "24h": -1.36741,
        "5m": -0.638032,
        "6h": -15.1299
      },
      "created_block": 84352016,
      "created_ts": 1791568845600,
      "decimals": 18,
      "fdv_usd": 1722014,
      "holders": 9446,
      "launchpad": null,
      "launchpad_name": null,
      "liquidity_usd": 160074,
      "logo": null,
      "market_cap_usd": 1722014,
      "name": "Giga Tenev",
      "price_eth": 0.000000722937,
      "price_usd": 0.00172201,
      "progress_pct": null,
      "quote": "ETH",
      "sell_volume_usd": {
        "1h": 23253.1,
        "24h": 653071,
        "5m": 2526.45,
        "6h": 172651
      },
      "sellers": {
        "1h": 228,
        "24h": 4433,
        "5m": 37,
        "6h": 1267
      },
      "sells": {
        "1h": 367,
        "24h": 10333,
        "5m": 38,
        "6h": 2570
      },
      "status": null,
      "symbol": "GIGATENEV",
      "traders": {
        "1h": 379,
        "24h": 5706,
        "5m": 57,
        "6h": 1701
      },
      "txns": {
        "1h": 655,
        "24h": 17735,
        "5m": 72,
        "6h": 4563
      },
      "volume_usd": {
        "1h": 44716.1,
        "24h": 1307062,
        "5m": 4857.72,
        "6h": 337384
      }
    },
    {
      "address": "0x30de7ae4c9578d110a97367ede9f7765cdce06ea",
      "buy_volume_usd": {
        "1h": 38569.1,
        "24h": 1745868,
        "5m": 1171.1,
        "6h": 300413
      },
      "buyers": {
        "1h": 106,
        "24h": 3033,
        "5m": 8,
        "6h": 679
      },
      "buys": {
        "1h": 275,
        "24h": 11949,
        "5m": 9,
        "6h": 1945
      },
      "change_pct": {
        "1h": -10.4998,
        "24h": -53.1886,
        "5m": 0.790503,
        "6h": -23.8595
      },
      "created_block": 94425334,
      "created_ts": 1792600484400,
      "decimals": 9,
      "fdv_usd": 2011643,
      "holders": 2456,
      "launchpad": null,
      "launchpad_name": null,
      "liquidity_usd": 272118,
      "logo": "https://ipfs.filebase.io/ipfs/QmeR3Yytm2RLS7NPbkzzz543DJfM6sk3DaQGZHA6mEWwsF",
      "market_cap_usd": 1995511,
      "name": "Pangea",
      "price_eth": 0.00000052634,
      "price_usd": 0.00125373,
      "progress_pct": null,
      "quote": "USDG",
      "sell_volume_usd": {
        "1h": 51816.8,
        "24h": 1854001,
        "5m": 2142.84,
        "6h": 324890
      },
      "sellers": {
        "1h": 131,
        "24h": 3361,
        "5m": 7,
        "6h": 824
      },
      "sells": {
        "1h": 244,
        "24h": 11434,
        "5m": 10,
        "6h": 2091
      },
      "status": null,
      "symbol": "PANGEA",
      "traders": {
        "1h": 184,
        "24h": 4181,
        "5m": 14,
        "6h": 1070
      },
      "txns": {
        "1h": 339,
        "24h": 15288,
        "5m": 15,
        "6h": 2674
      },
      "volume_usd": {
        "1h": 90385.9,
        "24h": 3599869,
        "5m": 3313.94,
        "6h": 625304
      }
    },
    {
      "address": "0xe01ada02fb4d1951cdb8cbb761d509db2ff02c94",
      "buy_volume_usd": {
        "1h": 436789,
        "24h": 7590722,
        "5m": 43478.8,
        "6h": 2177300
      },
      "buyers": {
        "1h": 646,
        "24h": 3504,
        "5m": 83,
        "6h": 2140
      },
      "buys": {
        "1h": 1256,
        "24h": 27801,
        "5m": 106,
        "6h": 7492
      },
      "change_pct": {
        "1h": 46.1081,
        "24h": 27.7039,
        "5m": 1.75704,
        "6h": 79.8324
      },
      "created_block": 92609286,
      "created_ts": 1792412328600,
      "decimals": 18,
      "fdv_usd": 35959968,
      "holders": 8208,
      "launchpad": null,
      "launchpad_name": null,
      "liquidity_usd": 590655,
      "logo": "https://ipfs.filebase.io/ipfs/bafkreid54stiiy2eguahowkokprffrvyfcuxpgumm37kwg7b375weqtgmq",
      "market_cap_usd": 35959968,
      "name": "Universal High Income",
      "price_eth": 0.0000150967,
      "price_usd": 0.03596,
      "progress_pct": null,
      "quote": "ETH",
      "sell_volume_usd": {
        "1h": 385373,
        "24h": 7552732,
        "5m": 41177.2,
        "6h": 2101469
      },
      "sellers": {
        "1h": 308,
        "24h": 3132,
        "5m": 39,
        "6h": 1487
      },
      "sells": {
        "1h": 736,
        "24h": 20732,
        "5m": 57,
        "6h": 5269
      },
      "status": null,
      "symbol": "UHI",
      "traders": {
        "1h": 796,
        "24h": 3607,
        "5m": 104,
        "6h": 2530
      },
      "txns": {
        "1h": 1890,
        "24h": 47165,
        "5m": 163,
        "6h": 12389
      },
      "volume_usd": {
        "1h": 822162,
        "24h": 15143454,
        "5m": 84656,
        "6h": 4278769
      }
    }
  ],
  "meta": {
    "block": 95504424,
    "block_age_ms": 687,
    "block_ts": 1792712998000,
    "chain": "robinhood",
    "finalized_block": 95493649,
    "lag_ms": 61,
    "list": "trending",
    "next_cursor": "3",
    "safe_block": 95497061,
    "stats_since": "chain_start",
    "window": "24h"
  }
}

Search

GET /v1/{chain}/search

Plan: Anonymous and above (no key needed) · Cost: 1 credit per call

Prefix search over token names and symbols, and exact match on token, pool, wallet and hook addresses and v4 pool ids. type narrows the result kind; up to 20 results.

Prefix on name / symbol, exact on address / pool id.

Parameters

Name	In	Type	Default	Description
`chain`	path, required	string		Chain slug (`robinhood`) or chain id (`4663`).
`q`	query	string	`shoot`	Search text: a name or symbol prefix, or an exact address / pool id.
`type`	query	string		Filter by item type. Comma list of `token`, `pool`, `wallet`, `hook`.
`limit`	query	integer	`10`	Maximum number of items to return. Up to 20.

Request

curl "https://api.crius.sh/v1/robinhood/search?q=charge&limit=3" \
  -H "x-api-key: $CRIUS_API_KEY"

const res = await fetch("https://api.crius.sh/v1/robinhood/search?q=charge&limit=3", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();

import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/search?q=charge&limit=3",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])

Try it in the playground →

Example response

Real response captured from the API (arrays trimmed to three items).

{
  "data": [
    {
      "address": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
      "label": null,
      "launchpad": "pons",
      "launchpad_name": "Pons",
      "liquidity_usd": 6869.4,
      "logo": "https://api.surplusllm.com/api/launchpad/logos/bb4315cb9506ef872830b1dab25ffdb6694df1b8b8e32cc2c8d083208f26baab.png",
      "name": "Charge AI",
      "price_usd": 0.00000576413,
      "symbol": "CHARGE",
      "type": "token"
    },
    {
      "address": "0x202e72dcbc815ca222f1a0674dd08755545b1329",
      "label": null,
      "launchpad": "pons",
      "launchpad_name": "Pons",
      "liquidity_usd": 4928.79,
      "logo": "https://chargeit.fun/assets/charge-token.png",
      "name": "CHARGE",
      "price_usd": 0.00000297461,
      "symbol": "CHARGE",
      "type": "token"
    },
    {
      "address": "0xc15f9324d2742387f98e2dba6b3745e5390113ec",
      "label": null,
      "launchpad": "pons",
      "launchpad_name": "Pons",
      "liquidity_usd": 2518.27,
      "logo": "https://chargeit.fun/assets/charge-token.png",
      "name": "CHARGE",
      "price_usd": 0.00000691616,
      "symbol": "CHARGE",
      "type": "token"
    }
  ],
  "meta": {
    "block": 95504438,
    "block_age_ms": 1110,
    "block_ts": 1792712999000,
    "chain": "robinhood",
    "finalized_block": 95493649,
    "lag_ms": 4,
    "safe_block": 95497061
  }
}

Crius · Changelog · Status · llms.txt · Terms · Privacy

Questions? support@crius.sh