Skip to main content
GET
Token - Holder Chart

  • time_from and time_to are optional. If not passed, the latest records will be returned.
  • net_change: Absolute change in holder count compared to the reference point. Whether this is compared to the previous interval or the beginning of the queried range depends on the percent_mode parameter
  • percent_change: Percentage change in holder count relative to the same reference point as net_change. Expressed as a percentage (e.g., 0.035 = 0.035%).
  • This endpoint consumes 25 CU per request.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

Solana network only.

Available options:
solana

Query Parameters

token_address
string
required

Token mint address.

chart_type
enum<string>
default:1h

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

Available options:
1d,
1h,
1m,
1s
from
integer

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

Required range: 1 <= x <= 10000000000
to
integer

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

Required range: 1 <= x <= 10000000000
mode
enum<string>
default:padding

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

Available options:
no_fill,
padding
percent_mode
enum<string>
default:beginning

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

Available options:
beginning,
previous
count
integer
default:20

Maximum number of chart points to return.

Required range: 1 <= x <= 100

Response

JSON object containing token holder-count chart data

Response containing holder-count chart data for a Solana token.

success
boolean
required

Indicates whether the request was successful.

data
object[]
required

Holder-count chart points ordered according to the chart query.