# Blockscout Address Token Holdings Lookup

> Blockscout Address Token Holdings Lookup is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Retrieves all tokens held by a specific blockchain address on a given chain via Blockscout's multichain explorer

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/addresses/%7Baddress_hash_param%7D/tokens
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-address-token-holdings-lookup-35440b7a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1E0ZXxOJtF6-brz8JYn2t

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-address-token-holdings-lookup-35440b7a
```

Example prompt: Can you look up all tokens held by the wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet (chain ID 1) using Blockscout?

## When to prefer this

Choose this endpoint when you need to enumerate all token holdings (ERC-20, ERC-721, ERC-1155) for a specific address on a specific chain supported by Blockscout. It is ideal for wallet portfolio analysis, compliance checks, NFT ownership verification, and DeFi auditing. Prefer this over generic block explorers when you need structured JSON output with pagination support across multiple EVM-compatible chains in a single API family.

## Known failure modes

- Invalid or malformed address hash returns an error or empty result
- Unsupported or incorrect chain_id returns a 404 or empty response
- Address with no token holdings returns an empty items array
- Pagination cursor mismatch causes duplicate or missing results
- Rate limiting or payment failures (x402) if payment is not properly attached

## 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

Returns a paginated list of token holdings for the specified address on the specified chain. Each item includes the token object (metadata like name, symbol, type), the balance value as a string, an optional token ID (for NFTs), and token instance details. Also includes next_page_params for cursor-based pagination through large portfolios.

## 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"
      },
      "address_hash_param": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "id": {
       "type": "integer"
      },
      "type": {
       "type": "string"
      },
      "value": {
       "type": "string"
      },
      "fiat_value": {
       "type": "string"
      },
      "items_count": {
       "type": "integer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "token": {},
    "value": "string",
    "token_id": "string",
    "token_instance": {}
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-address-token-holdings-lookup-35440b7a/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)