# Blockscout Token List API

> Blockscout Token List API is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-12).

Retrieves a paginated list of tokens on a specified blockchain network, with filtering and sorting options

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-token-list-api-fc7ef079
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k8tKL8j4tA_iqk-Q2Y6Tz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-token-list-api-fc7ef079
```

Example prompt: Can you use Blockscout to list the top ERC-20 tokens by market cap on Base (chain ID 8453), showing up to 25 results sorted descending?

## When to prefer this

Use this endpoint when you need to enumerate or search for tokens on a specific blockchain supported by Blockscout, especially when you need rich metadata like market cap, holder counts, exchange rates, and bridge information. Prefer this over generic explorers when working with EVM-compatible chains and needing multichain coverage in a single API family.

## Known failure modes

- Invalid or unsupported chain_id returns an error or empty result
- Malformed contract_address_hash returns no results
- Pagination with stale next_page_params may return unexpected data
- Rate limiting or payment failure returns 402 or 429 status
- No tokens match the given filter criteria, returning an empty items array

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

A paginated JSON response containing an array of token objects, each with fields including name, symbol, decimals, type, icon URL, exchange rate, holders count, total supply, circulating supply, circulating market cap, 24h volume, bridge type, and contract address hash; plus next_page_params for cursor-based pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string"
      },
      "name": {
       "type": "string"
      },
      "sort": {
       "type": "string"
      },
      "type": {
       "type": "string"
      },
      "limit": {
       "type": "integer"
      },
      "order": {
       "type": "string"
      },
      "fiat_value": {
       "type": "string"
      },
      "market_cap": {
       "type": "string"
      },
      "items_count": {
       "type": "integer"
      },
      "is_name_null": {
       "type": "boolean"
      },
      "holders_count": {
       "type": "string"
      },
      "contract_address_hash": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "name": "string",
    "type": {},
    "symbol": "string",
    "decimals": "string",
    "icon_url": "string",
    "reputation": "string",
    "volume_24h": "string",
    "bridge_type": "string",
    "address_hash": "string",
    "total_supply": "string",
    "exchange_rate": "string",
    "holders_count": "string",
    "foreign_address": "string",
    "origin_chain_id": "string",
    "circulating_supply": "string",
    "circulating_market_cap": "string"
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-token-list-api-fc7ef079/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)