# Hermes x402 Toolkit – Base Chain Address Lookup

> Hermes x402 Toolkit – Base Chain Address Lookup is a paid API for AI agents from api.zlovev.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-19).

Returns on-chain data for a Base mainnet address including ETH balance, USDC balance, nonce, contract status, and block height — paid per call via x402/USDC.

## Facts

- Endpoint: GET https://api.zlovev.com/api/chain/address
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-x402-toolkit-base-chain-address-lookup-8f8b37dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n0Oc1u9t4A6bv57SidS1G

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 hermes-x402-toolkit-base-chain-address-lookup-8f8b37dd
```

Example prompt: Can you look up the on-chain details for Base mainnet address 0x8335...2913 — I want to know its ETH balance, USDC balance, and whether it's a smart contract?

## When to prefer this

Choose this endpoint when you need quick, no-signup on-chain lookups for Base mainnet addresses, especially in agent workflows where API key management is impractical and micropayment-per-call via x402/USDC is acceptable. Prefer it over general Ethereum RPC calls when you want a clean JSON response without raw RPC boilerplate.

## Known failure modes

- Invalid or malformed address (not a valid 0x-prefixed 20-byte hex) returns an error
- Address not found or zero-activity address may return zero balances
- Payment failure via x402 results in 402 response before data is returned
- Network congestion on Base may cause delayed or stale block data
- Non-Base mainnet addresses queried against Base RPC may return unexpected zero results

## How this service works

Pay-per-call data API for AI agents. No API key, no account, no signup — pay USDC on Base (eip155:8453) per request; free /api/meta lists all 22 endpoints. One call each: web page to LLM-ready text and link previews; China A-share quotes and limit-up pool; Chinese text and pinyin; Base/Ethereum on-chain reads (address, token, ERC-20 balances, tx, blocks, transfer history, gas price in USD); NFT records (collection, owner, and ipfs:// tokenURI resolved through public gateways); full-page screenshots; email verification without sending mail; ENS forward/reverse resolution; smart-contract due diligence (ABI, verified source, proxy); token security facts (owner, renounced ownership, paused, bytecode capability selectors); domain dossier (RDAP, DNS, TLS certificate, HTTP facts, hosting network).

## Output

Returns a JSON object with: ok (boolean success flag), block (latest block number at query time), nonce (transaction count), address (queried address), eth_balance (ETH balance as a string), is_contract (boolean), and usdc_balance (USDC balance as a string).

## 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",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "0x-prefixed 20-byte address on Base mainnet"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "block": 51396188,
  "nonce": 1,
  "address": "0x8335…2913",
  "eth_balance": "12.5",
  "is_contract": true,
  "usdc_balance": "1000.5"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-x402-toolkit-base-chain-address-lookup-8f8b37dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zlovev.com](https://www.zero.xyz/host/api.zlovev.com/llms.txt)