Skip to main content
GET
Token - Holder Trend

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

chain
enum<string>
required

A chain name listed in supported networks Supported blockchain chains

Available options:
sol,
eth,
bsc
tokenAddress
string
required

An address of a token

Query Parameters

resolution
string
default:1h

DTO.TOKEN.HOLDER_TREND.RESOLUTION Aggregation resolution: 1h (default) | 1d

from
integer<int64>

DTO.TOKEN.HOLDER_TREND.FROM Start timestamp in Unix milliseconds (default: 30 days ago)

to
integer<int64>

DTO.TOKEN.HOLDER_TREND.TO End timestamp in Unix milliseconds (default: now)

Response

200 - application/json

Holder trend data points

bluechipAmountRatio
string
required

Bluechip holder ratio (0–1)

Example:

"0.0200"

bundleAmountRatio
string
required

Bundle (bundler) wallet holding ratio (0–1)

Example:

"0.0006"

creatorsAmountRatio
string
required

Creator wallet holding ratio (0–1)

Example:

"0.0050"

devAmountRatio
string
required

Dev wallet holding ratio (0–1)

Example:

"0.0100"

freshAmountRatio
string
required

Fresh wallet holding ratio (0–1)

Example:

"0.1500"

holders
string
required

Total holder count

Example:

"644381"

insiderAmountRatio
string
required

Insider wallet holding ratio (0–1)

Example:

"0.0200"

kolAmountRatio
string
required

KOL wallet holding ratio (0–1)

Example:

"0.0300"

phishingAmountRatio
string
required

Phishing (entrapment) wallet holding ratio (0–1)

Example:

"0.1400"

proAmountRatio
string
required

Pro wallet holding ratio (0–1)

Example:

"0.0300"

ratAmountRatio
string
required

Rat trader holding ratio (0–1)

Example:

"0.0001"

sandwichAmountRatio
string
required

Sandwich bot holding ratio (0–1)

Example:

"0.0020"

smartAmountRatio
string
required

Smart wallet holding ratio (0–1)

Example:

"0.0800"

sniperAmountRatio
string
required

Sniper wallet holding ratio (0–1)

Example:

"0.0050"

timestamp
integer<int64>
required

Unix timestamp in milliseconds (start of the hour or day bucket)

Example:

1747353600000

top100HoldersRatio
string
required

Top-100 holder ratio (0–1)

Example:

"0.2500"

top10HoldersRatio
string
required

Top-10 holder ratio (0–1)

Example:

"0.0832"

top50HoldersRatio
string
required

Top-50 holder ratio (0–1)

Example:

"0.1500"