메인 콘텐츠로 건너뛰기
GET
/
v2
/
token
/
{chain}
/
{tokenAddress}
/
holderTrend
토큰 - 홀더 추세
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"
  }
]

인증

​
Authorization
string
header
필수

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

경로 매개변수

​
chain
enum<string>
필수

지원되는 네트워크에 나열된 체인 이름 Supported blockchain chains

사용 가능한 옵션:
sol,
eth,
bsc
​
tokenAddress
string
필수

토큰 주소

쿼리 매개변수

​
resolution
string
기본값: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)

응답

200 - application/json

홀더 추세 데이터

​
bluechipAmountRatio
string
필수

Bluechip holder ratio (0–1)

예시:

"0.0200"

​
bundleAmountRatio
string
필수

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

예시:

"0.0006"

​
creatorsAmountRatio
string
필수

Creator wallet holding ratio (0–1)

예시:

"0.0050"

​
devAmountRatio
string
필수

Dev wallet holding ratio (0–1)

예시:

"0.0100"

​
freshAmountRatio
string
필수

Fresh wallet holding ratio (0–1)

예시:

"0.1500"

​
holders
string
필수

Total holder count

예시:

"644381"

​
insiderAmountRatio
string
필수

Insider wallet holding ratio (0–1)

예시:

"0.0200"

​
kolAmountRatio
string
필수

KOL wallet holding ratio (0–1)

예시:

"0.0300"

​
phishingAmountRatio
string
필수

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

예시:

"0.1400"

​
proAmountRatio
string
필수

Pro wallet holding ratio (0–1)

예시:

"0.0300"

​
ratAmountRatio
string
필수

Rat trader holding ratio (0–1)

예시:

"0.0001"

​
sandwichAmountRatio
string
필수

Sandwich bot holding ratio (0–1)

예시:

"0.0020"

​
smartAmountRatio
string
필수

Smart wallet holding ratio (0–1)

예시:

"0.0800"

​
sniperAmountRatio
string
필수

Sniper wallet holding ratio (0–1)

예시:

"0.0050"

​
timestamp
integer<int64>
필수

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

예시:

1747353600000

​
top100HoldersRatio
string
필수

Top-100 holder ratio (0–1)

예시:

"0.2500"

​
top10HoldersRatio
string
필수

Top-10 holder ratio (0–1)

예시:

"0.0832"

​
top50HoldersRatio
string
필수

Top-50 holder ratio (0–1)

예시:

"0.1500"