Holders

Live-streamed list of wallets that hold a given token with balance updates. Also has the unique count of holders for that token.

ℹī¸

This endpoint is available on Codex Growth and Enterprise Plans

Endpoint: onHoldersUpdated

Tracks the entire list of holders for a token, with balances if requested (some networks are not completely backfilled. A status is returned if the token has no holders). The websocket will only return the list of balances that were updated.

To limit results further, you can query a specified number of top holders that you would like to track and then subscribe to their balance updates.

Method: POST

Arguments

NameTypeDescription
tokenIdString!

Required

Response

NameTypeDescription
balances[Balance!]!The list of wallets holding the token.
holdersInt!The number of different wallets holding the token.
networkIdInt!The network ID that the token is deployed on.
tokenAddressString!The token's contract address.
tokenIdString!The ID of the token (tokenAddress:networkId).

👋

Join our Discord

Ask questions, share what you're working on and request new features đŸ‘Ŧ👭