Holder-count time series for a token
Returns the distinct holder count for a token sampled once per hour (or per 6h/1d bucket). Data is event-driven — a row exists only for hours the mint traded. Quiet hours produce gaps, not zeros; frontends should forward-fill the last value.
No pre-launch backfill: history starts at Phase 3 launch (2026-05-28) and grows forward. Empty mints return results: [] with a coverage_note.
Downsampling at 6h/1d returns the last value in the bucket (point-in-time count, not a flow).
Data freshness is ~3–5 seconds after a trade.
Authorizations
Preferred for swaps-api endpoints (/swaps/*, /stats/*, /trending, /pool-events).
Path Parameters
Token mint (base58).
Query Parameters
Bucket size. 6h/1d downsample to last-value-in-bucket.
1h, 6h, 1d Start of range (Unix ms, inclusive). Default: 24h before to.
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.