List ERC-20 tokens

Description

Returns ERC-20 tokens deployed on the Bittensor EVM chain. Each row exposes the contract address, standard token metadata (name, symbol, decimals), the deployer address, the block number and timestamp of deployment, and the transaction hash of the deploy.

Use this to discover deployed tokens, resolve a contract by address/name/symbol, or enumerate the ERC-20 registry before drilling into holders or transfers via /api/evm/erc20/account/v1 and /api/evm/erc20/transfer/v1.

Endpoint

GET /api/evm/erc20/token/v1

Parameters

Name	In	Type	Required	Description
address	query	string
name	query	string
symbol	query	string
page	query	integer
limit	query	integer
order	query	—

Responses

200 — Tokens retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "address",
          "name",
          "symbol",
          "decimals",
          "created_at_block_number",
          "created_at_timestamp",
          "created_by",
          "transaction_hash"
        ],
        "properties": {
          "address": {
            "type": "string"
          },
          "created_at_block_number": {
            "type": "integer",
            "format": "int32"
          },
          "created_at_timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "created_by": {
            "type": "string"
          },
          "decimals": {
            "type": "integer",
            "format": "int32"
          },
          "name": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "transaction_hash": {
            "type": "string"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}

400 — Bad request

404 — Tokens not found

500 — Internal server error

Try it

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.