# Blockscout Address Lookup

> Blockscout Address 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).

Retrieve detailed on-chain information about a specific blockchain address or smart contract by chain and address hash

## Facts

- Endpoint: GET https://api.blockscout.com/:chain_id/api/v2/addresses/:address_hash_param
- 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-lookup-9caf46da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dgug3DPA6IFTxg4CmlFTI

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-lookup-9caf46da
```

Example prompt: Can you pull up all the on-chain details for Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 using Blockscout — I want to know if it's a contract, its current balance, and how many transactions it's had?

## When to prefer this

Choose this endpoint when you need comprehensive on-chain metadata about a specific Ethereum-compatible address or contract across multiple EVM chains, especially when you need contract verification status, deployer info, or balance data in a single call. Prefer this over a general blockchain RPC call when you want enriched, human-readable metadata (labels, ENS, verification) that raw node calls don't provide. Ideal for agents doing due diligence on contracts, auditing wallets, or enriching address data in DeFi or security workflows.

## Known failure modes

- Invalid or malformed address hash returns a 404 or validation error
- Unsupported or unknown chain_id returns an error or empty response
- Address exists on-chain but has no indexed data yet due to sync lag
- Rate limiting or payment failure (x402) blocks the request
- Contract not yet verified returns limited metadata with no ABI

## How this service works

Access to api/v2/addresses/:address_hash. Retrieve detailed information about a specific address or contract

## Output

Returns a structured object containing the address type (EOA or contract), native token balance, total transaction count, contract-specific fields (verified status, name, compiler, ABI availability, creation transaction, deployer address), any associated ENS or public name tags, and token holdings summary. For contracts, additional metadata about source code verification and implementation proxy info may be included.

## 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"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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