# ChainScope Wallet Scan

> ChainScope Wallet Scan is a paid API for AI agents from chainsscope.duckdns.org, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Performs a full multi-chain wallet scan returning balances, token holdings, recent transaction activity, total USD value, and sanctions flagging for a given address on Ethereum, Base, Bitcoin, or Solana.

## Facts

- Endpoint: POST https://chainsscope.duckdns.org/tools/wallet-scan
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainscope-wallet-scan-87290dfd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L55OKJtc8zTIACBfSBokC

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 chainscope-wallet-scan-87290dfd -d '<json body>'
```

Example prompt: Can you do a full wallet scan on 0x1f5f8474fA0dc1Fde79187abd68Ef8Ea15ADAe34 on Ethereum — I want to see all token holdings, recent activity, total USD value, and whether it's sanctioned?

## When to prefer this

Choose this endpoint when you need a single unified call to get comprehensive wallet intelligence — balances, tokens, activity, USD values, and safety flags — across Ethereum, Base, Bitcoin, or Solana, without building and maintaining four separate chain integrations. It is especially valuable when sanctions/safety flagging is needed alongside portfolio data in one response.

## Known failure modes

- Invalid or malformed address for the specified chain returns an error
- Unsupported chain identifier causes a 400-level error
- Address with no on-chain history may return empty token_holdings and recent_activity arrays with availability flags set to false
- Network timeout or upstream RPC failure may return a 500-level error
- Rate limiting or insufficient payment may block the request

## How this service works

The flagship: balance, token holdings, recent activity, USD portfolio value, and an OFAC sanctions-list check for a wallet, in one call -- across Ethereum, Base, Arbitrum, Optimism, Polygon, Bitcoin, and Solana. Cheaper and simpler than calling wallet-balance + token-holdings + address-activity separately. Sanctions screening only (not a general scam detector) -- an honest, narrower claim, not a vague safety score.

## Output

Returns a JSON object containing: chain name, address, sanctioned boolean, native token symbol and balance, list of token holdings with symbol/balance/USD value/contract address, recent transaction activity with direction/counterparty/value/timestamp, total portfolio USD value, and availability flags indicating whether activity and token data were retrievable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "bitcoin",
    "solana",
    "arbitrum",
    "optimism",
    "polygon"
   ],
   "type": "string"
  },
  "address": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "ethereum",
  "address": "0x1f5f8474fA0dc1Fde79187abd68Ef8Ea15ADAe34",
  "sanctioned": false,
  "native_symbol": "ETH",
  "native_balance": "1.5",
  "token_holdings": [
   {
    "symbol": "USDC",
    "balance": "100",
    "value_usd": 100,
    "raw_balance": "100000000",
    "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
   }
  ],
  "recent_activity": [
   {
    "value": "0.5",
    "tx_hash": "0xabababababababababababababababababababababababababababababababab",
    "direction": "in",
    "timestamp": "2026-07-20T12:00:00+00:00",
    "counterparty": "0xcccc000000000000000000000000000000cccc"
   }
  ],
  "total_value_usd": 2912.5,
  "native_value_usd": 2812.5,
  "activity_available": true,
  "token_holdings_available": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainscope-wallet-scan-87290dfd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainsscope.duckdns.org](https://www.zero.xyz/host/chainsscope.duckdns.org/llms.txt)