Query token top holders by chain name and token address
Description
Method: HTTPS POST
Encoding：UTF-8
Path：https://api.blockin.ai/v2/quot/token/holder
Description：Query the list of top holders of a token
Request Header
Content-Type
Y
String
application/json
AccessKey
Y
String
1bdb01c947c54919b64d1fc6794atest
Request Parameters
chain_name
Y
String
Chain's name
token_address
Y
String
Token's address
Response
Public Response
success
Y
Boolean
Success Boolean
data
Y
Map<String, Object>
Response object
error_code
N
String
Error code
error_msg
N
String
Error message
Response Content
coin_infos
Y
Object
Token info
stat_coins
Y
Object
Token Statistics
holder_infos
Y
Object
Top 100 holders
Coin_infos Content
token_name
Y
String
Token's name
token_address
Y
String
Token's address
chain_name
Y
String
Chain's name
symbol
Y
String
Token's symbol
token_logo
Y
String
Token's logo
type
Y
String
Type: Coin, Token
Y
String
The twitter
Y
String
The facebook
Y
String
The reddit
telegram
Y
String
The telegram
website
Y
String
The website
explorers
Y
List
The explorers
soucre_code
Y
String
Soucre code
whitepaper
Y
String
Whitepaper
tags
N
List
Tags
update_at
Y
Long
Update time
Stat_coins Content
token_name
Y
String
Token's name
token_address
Y
String
Token's address
market_cap
Y
BigDecimal
Market cap
market_cap_usd
Y
BigDecimal
Market cap in USD
max_supply
N
BigDecimal
Max supply
total_supply
Y
BigDecimal
Total supply
circulating_supply
Y
BigDecimal
Circulating supply
fully_diluted_market_cap
Y
BigDecimal
Fully diluted market cap
fully_diluted_market_cap_usd
Y
BigDecimal
Fully diluted market cap in USD
volume_24h
Y
BigDecimal
24 hours volume
volume_24h_usd
Y
BigDecimal
24 hours volume in USD
update_at
Y
Long
Update time
Holder_infos Content
token_name
Y
String
Token's name
token_address
Y
String
Token's address
chain_name
Y
String
Chain's name
address
Y
String
User address
ens_name
N
String
ENS name
exchange_name
N
String
Exchange
quantity
Y
BigDecimal
Amount of tokens held
percentage
Y
BigDecimal
Proportion of tokens held
change_7d
Y
BigDecimal
7-day change rate
update_at
Y
Long
Update time
Request Sample
curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" "https://api.blockin.ai/v2/quot/token/holder" --data ' { "token_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984", "chain_name":"Ethereum" }'
Successful Response Sample
{
"success": true,
"data": {
"coin_infos": {
"symbol": "UNI",
"type": "Token",
"twitter": "https://twitter.com/UniswapProtocol",
"facebook": null,
"reddit": "https://www.reddit.com/r/Uniswap",
"telegram": null,
"website": "https://uniswap.org",
"whitepaper": "https://uniswap.org/whitepaper.pdf",
"explorers": "[{'etherscan.io': 'https://etherscan.io/token/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984'}, {'bscscan.com': 'https://bscscan.com/token/0xbf5140a22578168fd562dccf235e5d43a02ce9b1'}, {'blockchair.com': 'https://blockchair.com/ethereum/erc-20/token/0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984'}, {'hecoinfo.com': 'https://hecoinfo.com/token/0x22c54ce8321a4015740ee1109d9cbc25815c46e6'}, {'blockscout.com': 'https://blockscout.com/xdai/mainnet/tokens/0x4537e328bf7e4efa29d05caea260d7fe26af9d74'}, {'polygonscan.com': 'https://polygonscan.com/token/0xb33eaad8d922b1083446dc23f610c2567fb5180f'}, {'snowtrace.io': 'https://snowtrace.io/token/0x8eBAf22B6F053dFFeaf46f4Dd9eFA95D89ba8580'}, {'solscan.io': 'https://solscan.io/account/8FU95xFJhUUkyyCLU13HSzDLs7oC4QZdXQHL6SCeab36'}, {'finder.terra.money': 'https://finder.terra.money/mainnet/address/terra1wyxkuy5jq545fn7xfn3enpvs5zg9f9dghf6gxf'}]",
"tags": "[{'Alameda Research Portfolio': 'https://www.coincarp.com/category/alameda-research/'}, {'Avalanche Ecosystem': 'https://www.coincarp.com/category/avalancheeco/'}, {'Blockchain Capital Portfolio': 'https://www.coincarp.com/category/blockchain-capital/'}, {'DAO': 'https://www.coincarp.com/category/dao/'}, {'Decentralized exchange': 'https://www.coincarp.com/category/dex-tokens/'}, {'Pantera Capital Portfolio': 'https://www.coincarp.com/category/pantera-capital/'}, {'Polygon Ecosystem': 'https://www.coincarp.com/category/polygoneco/'}, {'DeFi': 'https://www.coincarp.com/category/defi/'}, {'Yield Farming': 'https://www.coincarp.com/category/yield-farming/'}, {'BSC Ecosystem': 'https://www.coincarp.com/category/bsceco/'}, {'A16Z Portfolio': 'https://www.coincarp.com/category/a16z-portfolio/'}, {'AMM': 'https://www.coincarp.com/category/amm/'}, {'Heco Ecosystem': 'https://www.coincarp.com/category/heco-eco/'}, {'Coinbase Ventures Portfolio': 'https://www.coincarp.com/category/coinbase-ventures/'}, {'Solana Ecosystem': 'https://www.coincarp.com/category/solanaeco/'}]",
"token_name": "Uniswap",
"token_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"token_logo": "https://www.blockin.ai/image/token/0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984.png",
"chain_name": "Ethereum",
"soucre_code": "https://github.com/Uniswap/uniswap-v2-core",
"update_at": 1697385609
},
"stat_coins": {
"token_name": "Uniswap",
"token_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"market_cap": 104011.000000000000000000,
"market_cap_usd": 2950969630.000000000000000000,
"max_supply": 1000000000.000000000000000000,
"total_supply": 1000000000.000000000000000000,
"circulating_supply": 762209327.000000000000000000,
"fully_diluted_market_cap": 136460.000000000000000000,
"fully_diluted_market_cap_usd": 3871600000.000000000000000000,
"volume_24h": 1412.000000000000000000,
"volume_24h_usd": 40073119.000000000000000000,
"update_at": 1697590859
},
"holder_infos": [{
{
"address": "0x1a9c8182c09f50c8318d769245bea52c32be35bc",
"quantity": 363839570.534800000000000000,
"percentage": "36.384",
"token_name": "Uniswap",
"token_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"chain_name": "Ethereum",
"exchange_name": "",
"change_7d": "0",
"update_at": 1697159014
},
{
"address": "0x3d30b1ab88d487b0f3061f40de76845bec3f1e94",
"quantity": 43000000.000000000000000000,
"percentage": "4.3",
"token_name": "Uniswap",
"token_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"chain_name": "Ethereum",
"exchange_name": "",
"change_7d": "0",
"update_at": 1697159014
},
{
"address": "0x47173b170c64d16393a52e6c480b3ad8c302ba1e",
"quantity": 23047480.513200000000000000,
"percentage": "2.3047",
"token_name": "Uniswap",
"token_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"chain_name": "Ethereum",
"exchange_name": "",
"change_7d": "0",
"update_at": 1697159014
},
{
"address": "0x4b4e140d1f131fdad6fb59c13af796fd194e4135",
"quantity": 15659398.465200000000000000,
"percentage": "1.5659",
"token_name": "Uniswap",
"token_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"chain_name": "Ethereum",
"exchange_name": "",
"change_7d": "0",
"update_at": 1697159014
},
...
]
},
"error_code": null,
"error_msg": null
}Last updated