# Blockscout Multichain Address Metadata Lookup

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

Retrieves paginated address metadata (tags, labels, slugs) across multiple blockchain networks using Blockscout's multichain metadata service

## Facts

- Endpoint: GET https://api.blockscout.com/services/metadata/api/v1/addresses
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-multichain-address-metadata-lookup-091bc65c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CIW-EdsWj-81xVqGj-fBl

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-multichain-address-metadata-lookup-091bc65c
```

Example prompt: Can you look up blockchain addresses tagged as 'exchange' on chain ID 1 using Blockscout's address metadata service, and return the first 20 results?

## When to prefer this

Choose this endpoint when you need to look up labeled, tagged, or named blockchain addresses (such as exchanges, dapps, or verified contracts) across multiple chains using Blockscout's curated metadata. It is ideal for enriching raw on-chain data with human-readable address tags, filtering addresses by chain or tag type, or paginating through large address sets. Prefer alternatives if you need full transaction history, token balances, or real-time on-chain state.

## Known failure modes

- Invalid or unsupported chainId returns empty results or 400 error
- Missing required 'type' or 'method' fields in input causes schema validation failure
- Unknown slug returns empty items array
- Expired or invalid pageToken results in pagination errors or repeated first page
- Rate limiting or payment failure returns 402 payment required

## 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 JSON object containing a list of address items (string identifiers), an array of matching blockchain addresses, and next-page pagination parameters (pageSize and pageToken) for iterating through further results.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "slug": {
       "type": "string"
      },
      "chainId": {
       "type": "string"
      },
      "tagType": {
       "type": "string"
      },
      "pageSize": {
       "type": "integer"
      },
      "pageToken": {
       "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": [
   "string"
  ],
  "addresses": [
   "string"
  ],
  "nextPageParams": {
   "pageSize": 0,
   "pageToken": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-multichain-address-metadata-lookup-091bc65c/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)