# ChainVerdict Wallet Dossier API

> ChainVerdict Wallet Dossier API is a paid API for AI agents from chainverdict.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieves a comprehensive on-chain dossier (profile, risk assessment, and activity summary) for a given blockchain wallet address (EOA or contract).

## Facts

- Endpoint: GET https://chainverdict.xyz/v1/wallet/dossier/%7Baddress%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainverdict-wallet-dossier-api-858908c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3QrukSNDUEkP9aGnXIsMa

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 chainverdict-wallet-dossier-api-858908c3
```

Example prompt: Can you pull the full on-chain dossier for wallet address 0x742d35Cc6634C0532925a3b8D4C9b4B5F3a1e2f3 and tell me if it looks risky or has any red flags?

## When to prefer this

Choose this endpoint when you need a holistic, pre-packaged 'dossier' view of a blockchain wallet — combining risk scoring, activity profiling, and address classification in one pay-per-call lookup. Prefer it over raw blockchain RPCs or block explorers when you want structured risk intelligence rather than raw transaction data. Best suited for agent workflows doing counterparty due diligence, fraud detection, or wallet vetting at $0.01 per lookup cost.

## Known failure modes

- HTTP 402 returned if payment is not included — caller must pay $0.01 USDC via x402 protocol
- Invalid or malformed address returns an error (e.g. 400 Bad Request)
- Unknown or brand-new address with no on-chain history may return sparse/empty dossier
- Rate limiting or service unavailability returns 429 or 503
- Address not found on the supported chain returns empty or null result

## How this service works

x402 v2 pay-per-call. Unpaid requests receive HTTP 402 with payment requirements.

## Output

Returns a structured dossier for the queried wallet address, likely including: address type (EOA vs contract), on-chain activity summary, risk indicators or verdict score, transaction history highlights, associated labels or tags, and any known flags (e.g. mixer use, sanctioned counterparties, scam involvement).

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Base address (EOA or contract)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainverdict-wallet-dossier-api-858908c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainverdict.xyz](https://www.zero.xyz/host/chainverdict.xyz/llms.txt)