# Hermes x402 Toolkit – Base Wallet Dossier

> Hermes x402 Toolkit – Base Wallet Dossier is a paid API for AI agents from api.zlovev.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-18).

Returns an on-chain profile of a Base mainnet wallet address including ERC-20 holdings, transfer history summary, and risk flags — pay-per-call via USDC on Base, no API key required.

## Facts

- Endpoint: GET https://api.zlovev.com/api/dy/dossier
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-x402-toolkit-base-wallet-dossier-a2a11b1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KFDWYzc63Xx9E2Gs5FC_e

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-wallet-dossier-a2a11b1a
```

Example prompt: Can you pull a full on-chain dossier for Base wallet 0x2626...e481, scanning the last 500 blocks and summarizing up to 100 transfers — I want to see holdings, risk flags, and whether it's a contract or a regular wallet?

## When to prefer this

Choose this endpoint when you need a comprehensive, ready-to-use on-chain dossier for a Base mainnet wallet without setting up API keys or accounts. It is ideal for agents that need quick risk assessment, balance snapshots, or transfer summaries for an address they've just encountered, and where paying a small per-call USDC micropayment is acceptable. Prefer alternatives if you need Ethereum mainnet or other chain data, real-time mempool monitoring, or full historical transaction exports.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Address not on Base mainnet yields empty or zero holdings
- blocks parameter out of 50-5000 range may be rejected or clamped
- tx_limit out of 1-200 range may be rejected or defaulted
- Payment failure (insufficient USDC on Base) blocks the request with HTTP 402
- Newly created address with no on-chain history returns empty transfers and holdings arrays

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

A JSON object containing: whether the call succeeded, a nonce, the queried address, an array of ERC-20 token holdings with balances and decimals, a transfer summary (in/out counts, total matched, distinct tokens and counterparties), an array of risk flags with IDs and severity levels, an overall risk level string, the raw ETH balance, a boolean indicating whether the address is a smart contract, an address type label (e.g. 'eoa'), and the USDC balance as a convenience field.

## 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": {
      "blocks": {
       "type": "integer",
       "description": "How many recent blocks to scan for ERC-20 flow (50-5000, default 1000)"
      },
      "address": {
       "type": "string",
       "description": "Wallet address on Base mainnet (0x + 40 hex)"
      },
      "tx_limit": {
       "type": "integer",
       "description": "Max transfer rows to summarise, newest first (1-200, default 50)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "nonce": 431,
  "address": "0x2626…e481",
  "holdings": [
   {
    "symbol": "USDC",
    "balance": "12.5",
    "decimals": 6
   }
  ],
  "transfers": {
   "in_count": 12,
   "out_count": 114,
   "total_matched": 126,
   "distinct_tokens": 3,
   "distinct_counterparties": 9
  },
  "risk_flags": [
   {
    "id": "never_sent_tx",
    "level": "medium"
   }
  ],
  "risk_level": "low",
  "eth_balance": "0.001",
  "is_contract": false,
  "address_type": "eoa",
  "usdc_balance": "12.5"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-x402-toolkit-base-wallet-dossier-a2a11b1a/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)