# Batch token profiles

> Token profiles for up to 100 tokens, trimmed to the fields you ask for. Batch token profiles on Robinhood Chain: parameters, plan, credits, code and a real response.

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

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

Token profiles for up to **100 tokens**, trimmed to the fields you ask for. `fields` takes dot paths into the profile above (`price.usd`, `market.market_cap_usd`, `holders.count`…); an empty list returns full profiles.

> fields: dotted paths of the token profile.

## Path parameters

`chain`stringrequired

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

## Request body

```json
{
  "tokens": [
    "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
    "0x0bd7d308f8e1639fab988df18a8011f41eacad73"
  ],
  "fields": [
    "symbol",
    "price.usd",
    "price.change_pct.24h",
    "market.market_cap_usd",
    "market.liquidity_usd"
  ]
}
```

## 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/)[**How to get Robinhood Chain token data (token profile API)**Get a Robinhood Chain token's name, supply, price, market cap, holders, launchpad, liquidity lock and links in one API call. Real response, no API key needed.](https://docs.crius.sh/guides/get-token-data/)[**Get prices for many Robinhood Chain tokens in one call**Price up to 100 Robinhood Chain tokens in one request with the batch prices API, or get chosen profile fields for many tokens. Real responses, no key needed.](https://docs.crius.sh/guides/get-prices-for-many-tokens/)[**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/)[**Move from raw RPC calls to the Crius API on Robinhood Chain**Replace eth\_getLogs scans, slot0 math and Transfer replays with Crius API calls on Robinhood Chain: a mapping table, before/after code and credit costs.](https://docs.crius.sh/guides/migrate-from-rpc-to-crius/)[**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 wallets and portfolio apps**What a Robinhood Chain wallet or portfolio app needs from the Crius API: holdings, USD values, PnL, trade history and warnings about spam tokens.](https://docs.crius.sh/use-cases/wallets-and-portfolio-apps/)

## 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/)[GET/token/{address}/poolsToken marketsAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/token-markets/)

Request No key needed

 

**cURL**

```bash
curl -X POST "https://api.crius.sh/v1/robinhood/tokens/batch" \
  -H "x-api-key: $CRIUS_API_KEY" \
  -H "content-type: application/json" \
  -d '{"tokens":["0x7b8892cea949bc60d494681d1bc3ea96071ab0b8","0x0bd7d308f8e1639fab988df18a8011f41eacad73"],"fields":["symbol","price.usd","price.change_pct.24h","market.market_cap_usd","market.liquidity_usd"]}'
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/tokens/batch", {
  method: "POST",
  headers: {
    "x-api-key": process.env.CRIUS_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "tokens": [
      "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
      "0x0bd7d308f8e1639fab988df18a8011f41eacad73"
    ],
    "fields": [
      "symbol",
      "price.usd",
      "price.change_pct.24h",
      "market.market_cap_usd",
      "market.liquidity_usd"
    ]
  }),
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.post(
    "https://api.crius.sh/v1/robinhood/tokens/batch",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
    json={"tokens":["0x7b8892cea949bc60d494681d1bc3ea96071ab0b8","0x0bd7d308f8e1639fab988df18a8011f41eacad73"],"fields":["symbol","price.usd","price.change_pct.24h","market.market_cap_usd","market.liquidity_usd"]},
)
body = r.json()
print(body["data"])
```

Response 200 · captured Oct 28, 2026

```json
{
  "data": {
    "0x0bd7d308f8e1639fab988df18a8011f41eacad73": {
      "market": {
        "liquidity_usd": 73135530,
        "market_cap_usd": 90409474
      },
      "price": {
        "change_pct": {
          "24h": 0.286017
        },
        "usd": 2355.49
      },
      "symbol": "WETH"
    },
    "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8": {
      "market": {
        "liquidity_usd": 5611.8,
        "market_cap_usd": 3773.42
      },
      "price": {
        "change_pct": {
          "24h": -0.171971
        },
        "usd": 0.00000388948
      },
      "symbol": "CHARGE"
    }
  },
  "meta": {
    "block": 100406780,
    "block_age_ms": 575,
    "block_ts": 1793225076000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 196,
    "missing": [],
    "safe_block": 100401329
  }
}
```

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