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

Parameter	Required	Type	Description
Content-Type	Y	String	application/json
AccessKey	Y	String	1bdb01c947c54919b64d1fc6794atest

Request Parameters

Parameter	Required	Type	Description
chain_name	Y	String	Chain's name
token_address	Y	String	Token's address

Response

Public Response

Parameter	Required	Type	Description
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

Parameter	Required	Type	Description
coin_infos	Y	Object	Token info
stat_coins	Y	Object	Token Statistics
holder_infos	Y	Object	Top 100 holders

Coin_infos Content

Parameter	Required	Type	Description
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
twitter	Y	String	The twitter
facebook	Y	String	The facebook
reddit	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

Parameter	Required	Type	Description
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

Parameter	Required	Type	Description
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
}