Holders history
Holder-count time series: one point per holder refresh, with the floor flag and the owner-aggregated top-10 concentration at each snapshot.
Path parameters
| Field | Type | Description |
|---|---|---|
mintrequired | string | Token mint address (base58). |
Query parameters
| Field | Type | Description |
|---|---|---|
fromoptional | number (unix s) | Window start. Defaults to to − 7 days. |
tooptional | number (unix s) | Window end. Defaults to now. |
limitoptional | number | Max points (≤1000; the newest points of the window are kept). default 1000 |
networkoptional | mainnet | devnet | Network to read. Devnet returns an empty payload (with a note) until its ingestor lands. default mainnet |
Response fields
| Field | Type | Description |
|---|---|---|
from / to | number (unix s) | The resolved window actually queried. |
items[].unixTime | number (unix s) | Snapshot time. |
items[].count | number | null | Holder count at that refresh (a lower bound when countIsFloor is true). |
items[].countIsFloor | boolean | true = the bounded crawl capped at that refresh: the real count was >= count. |
items[].top10OwnersPct | number | null | Owner-aggregated, vault-excluded top-10 concentration at that refresh (see Security). null = unknown. |
Points are appended on every holder refresh of a SUBSCRIBED mint: the scheduled keeper cycle (default every 15 min) plus the lazy on-request refresh — so cadence is roughly 15-minutely while a mint is subscribed. Mints nobody subscribes accrue no history (their cached /holders snapshot still refreshes). Mints refreshed before this feature shipped start their series at deploy time.
Snapshots are returned ascending (chart-friendly). When the window holds more than `limit` points, the NEWEST `limit` points are kept. History is retained for 90 days by default (operator-configurable).