# Discovery & search

> Token lists (new, bonding, graduating, trending, top gainers and losers) and search across tokens, pools, wallets and hooks on Robinhood Chain.

Source: https://crius.sh/docs/reference/discovery/

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

| Endpoint | Method | Plan | Credits |
|---|---|---|---|
| [Token lists](#token-lists) | `GET /v1/{chain}/tokens` | Anonymous | 1 |
| [Search](#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**

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

[Try it in the playground →](https://crius.sh/docs/playground/?op=GET%20%2Fv1%2F%7Bchain%7D%2Ftokens)

### Example response

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

```json
{
  "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**

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

**JavaScript**

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

**Python**

```python
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 →](https://crius.sh/docs/playground/?op=GET%20%2Fv1%2F%7Bchain%7D%2Fsearch)

### Example response

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

```json
{
  "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
  }
}
```