Wallet Risk Snapshot

On-chain snapshot of an EVM address. $0.01 per request.

Reports only what is directly verifiable on-chain right now: address format, contract vs. externally-owned account, native balance, transaction count, and a simple activity heuristic. This is not a sanctions check, fraud score, or AML/compliance product -- it does not consult any off-chain reputation, blocklist, or sanctions data source.

What it does

Send an address (and optional chain). Get back whether it's a valid address, whether it's a smart contract, its native token balance, its transaction count (nonce), whether it's the null or common burn address, and a basic "unused" vs "active" signal.

Endpoint

Method	POST
Path	`/snapshot`
Content-Type	`application/json`

Fields

field	required	description
`address`	yes	The EVM address to inspect
`chain`	no	One of `ethereum` (default), `base`, `polygon`, `arbitrum`, `optimism`, `bnb`

Example

curl -X POST https://wallet-risk-snapshot.pdfextractapi.workers.dev/snapshot \
  -H "Content-Type: application/json" \
  -d '{"address": "0x0000000000000000000000000000000000dEaD", "chain": "ethereum"}'

Example response

{
  "address": "0x0000000000000000000000000000000000dEaD",
  "chain": "ethereum",
  "is_valid_address": true,
  "is_contract": false,
  "is_null_or_burn_address": true,
  "native_symbol": "ETH",
  "native_balance": "16.53",
  "native_balance_wei": "16530000000000000000",
  "tx_count": 0,
  "activity_signal": "unused"
}

Errors

Errors return a non-200 status with { "error": { "code": "...", "message": "..." } }. Common codes: missing_address, unknown_chain.

Payment

This endpoint is paid per-request via the x402 protocol (HTTP 402 + USDC). Unpaid requests receive a 402 response with payment instructions.