Skip to main content
GET
/
v2
/
token
/
{chain}
/
{tokenAddress}
/
holderTrend
Token - Holder Trend
curl --request GET \
  --url https://api.chainstream.io/v2/token/{chain}/{tokenAddress}/holderTrend \
  --header 'Authorization: Bearer <token>'
[
  {
    "bluechipAmountRatio": "0.0200",
    "bundleAmountRatio": "0.0006",
    "creatorsAmountRatio": "0.0050",
    "devAmountRatio": "0.0100",
    "freshAmountRatio": "0.1500",
    "holders": "644381",
    "insiderAmountRatio": "0.0200",
    "kolAmountRatio": "0.0300",
    "phishingAmountRatio": "0.1400",
    "proAmountRatio": "0.0300",
    "ratAmountRatio": "0.0001",
    "sandwichAmountRatio": "0.0020",
    "smartAmountRatio": "0.0800",
    "sniperAmountRatio": "0.0050",
    "timestamp": 1747353600000,
    "top100HoldersRatio": "0.2500",
    "top10HoldersRatio": "0.0832",
    "top50HoldersRatio": "0.1500"
  }
]

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"