Holders

Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.

ℹ️

This endpoint is available on Defined Growth and Enterprise Plans

ℹ️

This endpoint is only available on Ethereum (network ID 1).

Endpoint: holders

Method: POST

Arguments

NameTypeDescription
inputHoldersInput!

Required

NameTypeDescription
cursorString

A cursor for use in pagination.

tokenIdString!

The ID of the token (tokenAddress:networkId).

Required

Response

NameTypeDescription
countInt!the unique count of holders for the token.
cursorStringA cursor for use in pagination.
items[Balance!]!The list wallets for a token.
statusHoldersStatus!Status of holder. Disabled if on unsupported network or there is insufficient holder data.

Explorer