v1

latestOpenAPI 3.1.02026-07-2410781551.8 KB

Holder

Token - Holder Chart

Retrieve timestamped holder-count data points for visualizing a Solana token’s holder trends with configurable intervals, filters, and chart modes.

get/token/v1/holder/chart

Query parameters

token_addressstring required

Token mint address.

chart_type'1d' | '1h' | '1m' | '1s'

Holder-count chart interval. Supported values: 1d, 1h, 1m, 1s. Note: 1s chart type only supports data within the last 3 days.

frominteger

Start time for the chart as a unix timestamp in seconds.

tointeger

End time for the chart as a unix timestamp in seconds.

mode'no_fill' | 'padding'

Controls how chart data is handled. padding fills missing timestamps to maintain continuity; no_fill returns only timestamps where values change.

percent_mode'beginning' | 'previous'

Defines how holder-count percentage change is calculated. beginning compares each point with the first record; previous compares each point with the previous record.

countinteger

Maximum number of chart points to return.

Headers

x-chain'solana'

Solana network only.

Response

JSON object containing token holder-count chart data

successboolean required

Indicates whether the request was successful.