Skip to main content
GET
Holder-count time series for a token

Authorizations

X-API-Key
string
header
required

Preferred for swaps-api endpoints (/swaps/*, /stats/*, /trending, /pool-events).

Path Parameters

token
string
required

Token mint (base58).

Query Parameters

resolution
enum<string>
default:1h

Bucket size. 6h/1d downsample to last-value-in-bucket.

Available options:
1h,
6h,
1d
from
integer<int64>

Start of range (Unix ms, inclusive). Default: 24h before to.

to
integer<int64>

End of range (Unix ms, inclusive). Default: now.

Response

Holder-count series

Response for a single-series actor chart endpoint (/holders/chart/{token}, /snipers/chart/{token}, /insiders/chart/{token}, /bundlers/chart/{token}). Rows exist only for hours the mint traded — gaps are expected, not bugs. Forward-fill the last value for quiet hours. An empty results array carries a coverage_note explaining the no-backfill policy.

results
object[]
required
computed_at
integer<int64>
required

Unix ms when this response was assembled.

coverage_note
string

Present on empty results (no-backfill policy) or for the bundlers endpoint (Phase 5 placeholder).