Docs
⌘ K

Token Holders

GET/v1/evm/holders

Returns top token holders ranked by balance.

Query Parameters

ParameterDescriptionValue
network
string

The Graph Network ID for EVM networks https://thegraph.com/networks

  • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
Required
mainnet
contract
string

Filter by contract address

    		Required
    limit
    integer

    Number of items* returned in a single request.
    *Plan restricted.

    • Default value: 10
    • Minimum value: 1
    • Maximum value: 1000
    page
    integer

    Page number to fetch.
    Empty data array signifies end of results.

    • Default value: 1
    • Minimum value: 1
    • Maximum value: 767465558638

    Potential Responses

    StatusDescription
    200

    Successful Response

    400

    Client side error

    401

    Authentication failed

    403

    Forbidden

    404

    Not found

    500

    Server side error