Skip to main content
GET
/
v1
/
token
/
{chain}
/
{tokenAddress}
/
marketData
Token - Market Data
curl --request GET \
  --url https://api-dex.chainstream.io/v1/token/{chain}/{tokenAddress}/marketData \
  --header 'Authorization: Bearer <token>'
{
  "totalSupply": "1000000",
  "marketCapInUsd": "100000",
  "holders": 1000,
  "priceInUsd": "0.00000261383847574915906643405542",
  "tvlInUsd": "0.00000261383847574915906643405542",
  "marketCapInSol": "100000",
  "top10TotalHoldings": "100000",
  "top10HoldingsRatio": "0.1",
  "top100TotalHoldings": "500000",
  "top100HoldingsRatio": "0.5",
  "priceInSol": "0.00000261383847574915906643405542",
  "tvlInSol": "0.00000261383847574915906643405542",
  "completionRatio": "0.1",
  "top50TotalHoldings": "300000",
  "top50HoldingsRatio": "0.3",
  "bluechipTotalHolders": "10",
  "bluechipTotalHoldings": "50000",
  "bluechipHoldingsRatio": "0.05",
  "kolTotalHolders": "20",
  "kolTotalHoldings": "30000",
  "kolHoldingsRatio": "0.03",
  "sniperTotalHolders": "15",
  "sniperTotalHoldings": "25000",
  "sniperHoldingsRatio": "0.025",
  "proTotalHolders": "25",
  "proTotalHoldings": "40000",
  "proHoldingsRatio": "0.04",
  "insiderTotalHolders": "5",
  "insiderTotalHoldings": "20000",
  "insiderHoldingsRatio": "0.02",
  "sandwishTotalHolders": "8",
  "sandwishTotalHoldings": "15000",
  "sandwishHoldingsRatio": "0.015",
  "freshTotalHolders": "30",
  "freshTotalHoldings": "10000",
  "freshHoldingsRatio": "0.01",
  "bundleTotalHolders": "12",
  "bundleTotalHoldings": "18000",
  "bundleHoldingsRatio": "0.018",
  "devTotalHolders": "3",
  "devTotalHoldings": "5000",
  "devHoldingsRatio": "0.005"
}

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

Available options:
sol,
base,
bsc,
polygon,
arbitrum,
optimism,
avalanche,
eth,
zksync,
sui
​
tokenAddress
string
required

An address of a token

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

Response

200 - application/json
​
totalSupply
string
required

Total supply

Example:

"1000000"

​
marketCapInUsd
string
required

MarketCap in USD

Example:

"100000"

​
holders
number
required

Total number of token holders

Example:

1000

​
priceInUsd
string
required

Price in USD

Example:

"0.00000261383847574915906643405542"

​
tvlInUsd
string
required

TVL in USD

Example:

"0.00000261383847574915906643405542"

​
marketCapInSol
string

MarketCap in SOL

Example:

"100000"

​
top10TotalHoldings
string

Total holdings of top 10 holders

Example:

"100000"

​
top10HoldingsRatio
string

Ratio of holdings by top 10 holders

Example:

"0.1"

​
top100TotalHoldings
string

Total holdings of top 100 holders

Example:

"500000"

​
top100HoldingsRatio
string

Ratio of holdings by top 100 holders

Example:

"0.5"

​
priceInSol
string

Price in SOL

Example:

"0.00000261383847574915906643405542"

​
tvlInSol
string

TVL in SOL

Example:

"0.00000261383847574915906643405542"

​
completionRatio
string

Graduation completion progress

Example:

"0.1"

​
top50TotalHoldings
string

Total holdings of top 50 holders

Example:

"300000"

​
top50HoldingsRatio
string

Ratio of holdings by top 50 holders

Example:

"0.3"

​
bluechipTotalHolders
string

Total number of bluechip holders

Example:

"10"

​
bluechipTotalHoldings
string

Total holdings of bluechip holders

Example:

"50000"

​
bluechipHoldingsRatio
string

Ratio of holdings by bluechip holders

Example:

"0.05"

​
kolTotalHolders
string

Total number of KOL holders

Example:

"20"

​
kolTotalHoldings
string

Total holdings of KOL holders

Example:

"30000"

​
kolHoldingsRatio
string

Ratio of holdings by KOL holders

Example:

"0.03"

​
sniperTotalHolders
string

Total number of sniper holders

Example:

"15"

​
sniperTotalHoldings
string

Total holdings of sniper holders

Example:

"25000"

​
sniperHoldingsRatio
string

Ratio of holdings by sniper holders

Example:

"0.025"

​
proTotalHolders
string

Total number of pro holders

Example:

"25"

​
proTotalHoldings
string

Total holdings of pro holders

Example:

"40000"

​
proHoldingsRatio
string

Ratio of holdings by pro holders

Example:

"0.04"

​
insiderTotalHolders
string

Total number of insider holders

Example:

"5"

​
insiderTotalHoldings
string

Total holdings of insider holders

Example:

"20000"

​
insiderHoldingsRatio
string

Ratio of holdings by insider holders

Example:

"0.02"

​
sandwishTotalHolders
string

Total number of sandwish holders

Example:

"8"

​
sandwishTotalHoldings
string

Total holdings of sandwish holders

Example:

"15000"

​
sandwishHoldingsRatio
string

Ratio of holdings by sandwish holders

Example:

"0.015"

​
freshTotalHolders
string

Total number of fresh holders

Example:

"30"

​
freshTotalHoldings
string

Total holdings of fresh holders

Example:

"10000"

​
freshHoldingsRatio
string

Ratio of holdings by fresh holders

Example:

"0.01"

​
bundleTotalHolders
string

Total number of bundle holders

Example:

"12"

​
bundleTotalHoldings
string

Total holdings of bundle holders

Example:

"18000"

​
bundleHoldingsRatio
string

Ratio of holdings by bundle holders

Example:

"0.018"

​
devTotalHolders
string

Total number of dev holders

Example:

"3"

​
devTotalHoldings
string

Total holdings of dev holders

Example:

"5000"

​
devHoldingsRatio
string

Ratio of holdings by dev holders

Example:

"0.005"