# Live holders

> The current holder list, ranked by balance, with each holder's share of supply, USD value and labels (pools, lockers, burn addresses, the dev).

Source: https://docs.crius.sh/reference/holders/live-holders/ · Updated 2026-10-28

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

The current holder list, ranked by balance, with each holder's share of supply, USD value and labels (pools, lockers, burn addresses, the dev). Also returns the holder count and top-10 concentration.

## 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 `100`

Maximum number of items to return. Up to 500.

`exclude`string

Comma list of holder classes to leave out, such as `infra` (pools, lockers, burn) or `bots`.

## Key response fields

-   `count`, `top10_pct`
-   `holders[]`: `rank`, `address`, `balance`, `pct`, `value_usd`, `value_eth`, `label`

## Guides that use this endpoint

[**Get the holders of a Robinhood Chain token (token holders API)**Robinhood Chain token holders API: get any token's top holders in one call, with balance, share of supply, USD value, labels, holder count and top-10 share.](https://docs.crius.sh/guides/get-token-holders/)[**Get a token's holders at a past block, time or market cap**Get a Robinhood Chain token's holders at any past block, time, market cap or launch stage, valued at that moment's price, with cost basis per holder.](https://docs.crius.sh/guides/get-historical-holders/)[**Track a token's holder count over time**Chart a Robinhood Chain token's holder count over time: min, max, new and exited holders per interval, with your own definition of a holder. Real example.](https://docs.crius.sh/guides/track-holder-count/)[**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/)[**Get wallet token balances on Robinhood Chain (balances API)**Get every token balance of a Robinhood Chain wallet (USDG, tokenized stocks, ETH) in USD in one call, one token's balances across wallets, and batch prices.](https://docs.crius.sh/guides/get-wallet-token-balances/)

## 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 holders & traders endpoints

[GET/token/{address}/holders/snapshotHolder snapshotFree · 5 cr](https://docs.crius.sh/reference/holders/holder-snapshot/)[GET/token/{address}/holders/cohortHolder cohortStarter · 10 cr](https://docs.crius.sh/reference/holders/holder-cohort/)[GET/token/{address}/holders/historyHolder count historyStarter · 10 cr](https://docs.crius.sh/reference/holders/holder-count-history/)[GET/token/{address}/tradersTop tradersFree · 5 cr](https://docs.crius.sh/reference/holders/top-traders/)

Request Needs a Free key

 

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders?limit=5&exclude=infra" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders?limit=5&exclude=infra", {
  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/holders?limit=5&exclude=infra",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

Response 200 · captured Oct 28, 2026

```json
{
  "data": {
    "balances": "verified_onchain",
    "count": 178,
    "distribution": {
      "top10_pct": 13.436
    },
    "history": "complete",
    "holders": [
      {
        "address": "0x1860e8b874ed7742ae5459af731687ecb576c9fd",
        "balance": 28729479.389247917189540117,
        "label": null,
        "pct": 2.87295,
        "rank": 1,
        "value_eth": 0.0474081,
        "value_usd": 111.806
      },
      {
        "address": "0x346f5777f5652bd561dcd830e638bc40d3e1cf3d",
        "balance": 25566954.227971953484331514,
        "label": null,
        "pct": 2.5567,
        "rank": 2,
        "value_eth": 0.0421894,
        "value_usd": 99.4981
      },
      {
        "address": "0xa975e46d6552fb0ef85f7e9f7b640a058dc368bd",
        "balance": 23260835.335709034922247096,
        "label": null,
        "pct": 2.32608,
        "rank": 3,
        "value_eth": 0.038384,
        "value_usd": 90.5235
      },
      {
        "address": "0xf4e322c50010e00878b8d6bbb2c495d90097e58f",
        "balance": 19090692.939108585371870819,
        "label": null,
        "pct": 1.90907,
        "rank": 4,
        "value_eth": 0.0315026,
        "value_usd": 74.2947
      },
      {
        "address": "0x8e6be350c1276d3276cead49859aa435d77ac9eb",
        "balance": 12214695.452807030766083489,
        "label": null,
        "pct": 1.22147,
        "rank": 5,
        "value_eth": 0.0201561,
        "value_usd": 47.5356
      }
    ],
    "ledger_reliable": true
  },
  "meta": {
    "block": 100436633,
    "block_age_ms": 414,
    "block_ts": 1793228150000,
    "chain": "robinhood",
    "finalized_block": 100427397,
    "lag_ms": 17,
    "safe_block": 100431079
  }
}
```

[Get a key for this endpoint](https://dashboard.crius.sh/signup?ref=docs-endpoint) [Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Ftoken%2F%7Baddress%7D%2Fholders&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fholders%2Flive-holders%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)