# Holder count history

> Holder count over time at a chosen interval, with your own definition of a holder (min_balance or min_usd).

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

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

Holder count over time at a chosen interval, with your own definition of a holder (`min_balance` or `min_usd`). Answers "what was the minimum and maximum number of holders during a period".

> min / max / new / exited per interval.

## Path parameters

`chain`stringrequired

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

`address`stringrequired

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

## Query parameters

`interval`string Default `1h`

Bucket size. One of `1m`, `5m`, `15m`, `1h`, `4h`, `1d`.

`from`string

Start of the window (`block:`, `ts:`, `mcap:` or a label).

`to`string

End of the window (same forms as `from`).

`min_balance`number

Minimum balance in token units.

`min_usd`number

Only items worth at least this many USD.

`exclude`string

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

## Guides that use this endpoint

[**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/)[**Robinhood Chain API for analytics dashboards**Build Robinhood Chain dashboards with the Crius API: DEX volume without wash trades, TVL, launches per launchpad, hourly patterns and token charts.](https://docs.crius.sh/use-cases/analytics-dashboards/)

## 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}/holdersLive holdersFree · 2 cr](https://docs.crius.sh/reference/holders/live-holders/)[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}/tradersTop tradersFree · 5 cr](https://docs.crius.sh/reference/holders/top-traders/)

Request Needs a Starter key

 

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders/history?interval=1h&from=launch&to=now" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

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

Response 200 · captured Oct 28, 2026

```json
{
  "data": {
    "exited": [
      3082,
      1030,
      462,
      216,
      148
    ],
    "history": "complete",
    "holder_definition": {
      "exclude": [],
      "min_balance": null,
      "min_usd": null,
      "note": ""
    },
    "holders": [
      421,
      381,
      359,
      309,
      294
    ],
    "interval": "1d",
    "max": [
      476,
      429,
      382,
      359,
      313
    ],
    "min": [
      1,
      378,
      353,
      306,
      294
    ],
    "new": [
      3503,
      990,
      440,
      166,
      133
    ],
    "summary": {
      "max": 476,
      "max_ts": 1791936000000,
      "min": 1,
      "min_ts": 1791936000000,
      "now": 238
    },
    "t": [
      1791936000000,
      1792022400000,
      1792108800000,
      1792195200000,
      1792281600000
    ]
  },
  "meta": {
    "block": 100406819,
    "block_age_ms": 372,
    "block_ts": 1793225080000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 41,
    "safe_block": 100401329
  }
}
```

[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%2Fhistory&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fholders%2Fholder-count-history%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)