# Token markets

> Every market the token trades in: Uniswap v2 pairs, v3 pools (all fee tiers), v4 pools (with their hook) and launchpad bonding curves, with liquidity and 24h…

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

GET https://api.crius.sh/v1/{chain}/token/{address}/pools

Every market the token trades in: Uniswap v2 pairs, v3 pools (all fee tiers), v4 pools (with their hook) and launchpad bonding curves, with liquidity and 24h activity. Paginate with `cursor`.

> Uniswap V2/V3/V4, Pons and launchpad curves, ranked by USD liquidity (2 x quote side, from each pool's own state). is\_price\_pool marks the market the token price comes from. meta.total = all pools.

## Path parameters

`chain`stringrequired

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

`address`stringrequired

Contract or wallet address, any case (`0x…`, 20 bytes).

## Query parameters

`limit`integer Default `50`

Maximum number of items to return. Up to 200.

`cursor`string

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

## Guides that use this endpoint

[**Find every pool and the liquidity of a Robinhood Chain token (liquidity API)**Robinhood Chain liquidity API: list every Uniswap v2, v3 and v4 pool and launch curve of a token, with USD liquidity, fees, hooks and the price pool. No key.](https://docs.crius.sh/guides/get-token-pools-and-liquidity/)[**Robinhood Chain DEX data: which DEXs trade, and how to get their trades, pools and volume**Which DEXs trade on Robinhood Chain (Uniswap v2, v3, v4 with hooks, launchpad curves), their real 24h volume and pools, and the API calls for DEX trades.](https://docs.crius.sh/guides/robinhood-chain-dex-data/)[**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 tokens & prices endpoints

[GET/token/{address}Token profileAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/token-profile/)[GET/token/{address}/priceToken priceAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/token-price/)[GET/pricesBatch pricesAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/batch-prices/)[POST/pricesBatch prices (POST)Anonymous · 1 cr](https://docs.crius.sh/reference/tokens/batch-prices-post/)[POST/tokens/batchBatch token profilesAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/batch-token-profiles/)

Request No key needed

  

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/pools?limit=3" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/pools?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/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/pools?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": [
    {
      "amounts": {
        "token0": 1.18969,
        "token1": 720478686
      },
      "base": {
        "address": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
        "logo": "https://api.crius.sh/v1/robinhood/logo/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8.png?size=128",
        "symbol": "CHARGE"
      },
      "created_block": 88461321,
      "dex": "uniswap_v4",
      "dynamic_fee": false,
      "fee": 0,
      "hook": {
        "address": "0xe5e702641ea86f4ae6cc3cdaed2b886f976be044",
        "name": "pons_v2_meme_hook"
      },
      "is_price_pool": true,
      "liquidity_usd": 5604.57,
      "pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
      "price_usd": 0.00000388948,
      "quote": {
        "address": "0x0000000000000000000000000000000000000000",
        "logo": null,
        "symbol": "ETH"
      },
      "quote_liquidity_usd": 2802.29,
      "state": {
        "liquidity": 29277002188455996438188,
        "reserve0": 0,
        "reserve1": 0,
        "sqrt_price_x96": 1949728392666469411451966154432124,
        "tick": 202227
      },
      "swaps_indexed": 432,
      "tick_spacing": 200
    },
    {
      "amounts": {
        "token0": 3.1477,
        "token1": 115029
      },
      "base": {
        "address": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
        "logo": "https://api.crius.sh/v1/robinhood/logo/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8.png?size=128",
        "symbol": "CHARGE"
      },
      "created_block": 88461495,
      "dex": "uniswap_v4",
      "dynamic_fee": false,
      "fee": 850000,
      "hook": null,
      "is_price_pool": false,
      "liquidity_usd": 6.29539,
      "pool": "0xe928234e515b0c000dd6aa1c60cf5a009082367cda4775a5b63b4ff0c83dcdd3",
      "price_usd": 0.0000273644,
      "quote": {
        "address": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
        "logo": null,
        "symbol": "USDG"
      },
      "quote_liquidity_usd": 3.1477,
      "state": {
        "liquidity": 601728037770030,
        "reserve0": 0,
        "reserve1": 0,
        "sqrt_price_x96": 15145615706034675540349663040887263187,
        "tick": 381391
      },
      "swaps_indexed": 3,
      "tick_spacing": 60
    },
    {
      "amounts": {
        "token0": 0.328859,
        "token1": 35779.5
      },
      "base": {
        "address": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
        "logo": "https://api.crius.sh/v1/robinhood/logo/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8.png?size=128",
        "symbol": "CHARGE"
      },
      "created_block": 88466617,
      "dex": "uniswap_v4",
      "dynamic_fee": false,
      "fee": 450000,
      "hook": null,
      "is_price_pool": false,
      "liquidity_usd": 0.657719,
      "pool": "0x1a184f0aa1978e7b543ee944a30df88dd34fcb667aa5a9142bb399ef582481b8",
      "price_usd": 0.00000919127,
      "quote": {
        "address": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
        "logo": null,
        "symbol": "USDG"
      },
      "quote_liquidity_usd": 0.328859,
      "state": {
        "liquidity": 108473206521826,
        "reserve0": 0,
        "reserve1": 0,
        "sqrt_price_x96": 26133147987752847079481471382601445977,
        "tick": 392302
      },
      "swaps_indexed": 4,
      "tick_spacing": 4500
    }
  ],
  "meta": {
    "block": 100406784,
    "block_age_ms": 826,
    "block_ts": 1793225076000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 11,
    "next_cursor": "3",
    "safe_block": 100401329,
    "total": 10
  }
}
```

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