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
| Name | Type | Description |
|---|---|---|
| tokenId | String! | Required |
Response
| Name | Type | Description |
|---|---|---|
| balances | [Balance!] ! | The list of wallets holding the token. |
| holders | Int! | The number of different wallets holding the token. |
| networkId | Int! | The network ID that the token is deployed on. |
| tokenAddress | String! | The token's contract address. |
| tokenId | String! | The ID of the token (
). |
Ask questions, share what you're working on and request new features 👬👭