Ultron.
Tool reference / Ultron

get_token_holders

Get ranked holder addresses and their percentage of total supply for an exact Robinhood ERC-20 token. Requires the user’s Blockscout key. Includes contracts and burn addresses; not beneficial ownership or circulating supply.

Updated September 8, 2026 · Independent beta

Analyze top token holders

Get ranked holder addresses and their percentage of total supply for an exact Robinhood ERC-20 token. Requires the user’s Blockscout key. Includes contracts and burn addresses; not beneficial ownership or circulating supply.

Permission and calling convention

Required scope: chain:read. This tool reads data or account-owned state.

This tool does not sign or broadcast a transaction. Check errors, source timestamps and explicit unavailable fields before using the result.

POST /api/tools/get_token_holders
Authorization: Bearer <ULTRON_ACCESS_KEY>
Content-Type: application/json

Input schema

Inputs are validated against this current schema. Use exact values from live source results rather than substituting a ticker for a contract or a different chain.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^0x[\\da-fA-F]{40}$"
    },
    "top": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "token",
    "top"
  ],
  "additionalProperties": false
}

Need a concrete starting point?

Build something →Track something →