honeypot logo

This documentation is incomplete. We are working on it. If you have any questions, please contact us.

GET/v1/TopHolders

Get Top Holders

This endpoint retrieves the top 50 holders for the specified token. Premium API allows retrieving more holders.

Alias is not currently set.

Required attributes

  • Name
    address
    Type
    address
    Description

    The address of the token to retrieve pairs for.

  • Name
    chainID
    Type
    integer
    Description

    The chain you want to check the token on. Unlike some other endpoints, this field is required here.

Request

GET
/v1/TopHolders
curl -G https://api.honeypot.is/v1/TopHolders \
-H "X-API-KEY: {APIKEY}" \
-d address=0xe786c0da51a21c8f7ec91c9889e2df3f21ee1747 \
-d chainID=1

Response

GET
/v1/TopHolders
{
    "totalSupply": "28247199602143667875022",
    "holders": [
        {
            "address": "0x663A5C229c09b049E36dCc11a9B0d4a8Eb9db214",
            "balance": "27830592101166458317451",
            "alias": "",
            "isContract": true
        },
        {
            "address": "0x04bDa42de3bc32Abb00df46004204424d4Cf8287",
            "balance": "281117091930974326438",
            "alias": "",
            "isContract": false
        },
        {
            "address": "0x16BCA6D06425daa0B0724086eB1e3b7D499ef403",
            "balance": "135490409046235230133",
            "alias": "",
            "isContract": false
        },
        {
            "address": "0x0000000000000000000000000000000000000000",
            "balance": "1000",
            "alias": "",
            "isContract": false
        }
    ]
}