# Wallet X-Ray — On-Chain Portfolio & Risk Analysis

> Wallet X-Ray — On-Chain Portfolio & Risk Analysis is a paid API for AI agents from x402-endpoints.onrender.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns native + ERC-20 balances, USD portfolio valuation, token count, and OFAC sanctions flag for any EVM wallet address in a single call

## Facts

- Endpoint: GET https://x402-endpoints.onrender.com/crypto/wallet-xray
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wallet-x-ray-on-chain-portfolio-risk-analysis-bbc91281
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_71bAtoLQSw6iEMk9mL858

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 wallet-x-ray-on-chain-portfolio-risk-analysis-bbc91281
```

Example prompt: Do a full wallet x-ray on 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — I need the total USD portfolio value, all token balances, and whether it's flagged by OFAC sanctions.

## When to prefer this

Choose this endpoint when you need a comprehensive single-call wallet audit combining balance aggregation, USD valuation, and OFAC compliance screening. Prefer it over primitive balance-only or sanctions-only endpoints when you need the full risk picture in one call — especially useful for compliance workflows, due diligence before transacting, or portfolio dashboards on EVM chains including Ethereum, Base, Optimism, Arbitrum, Polygon, and Gnosis.

## Known failure modes

- Invalid or malformed wallet address returns a 400-level error
- Unsupported chain name returns an error or defaults to base
- Wallet with zero on-chain activity returns empty balances and $0 portfolio value
- Third-party data source (Blockscout, DexScreener) downtime may cause partial or failed responses
- Very new tokens without DEX pricing may show zero USD value despite non-zero balance

## How this service works

Wallet risk analysis in one call — native + ERC-20 balances, USD portfolio valuation, token count and an OFAC sanctions flag (Blockscout, DexScreener, OFAC list). A full on-chain wallet x-ray with risk flags, where primitives serve one field per call this returns the whole valued portfolio plus risk. EVM chains.

## Output

Returns the wallet's native token balance, all ERC-20 token balances with USD valuations, total portfolio USD value, total token count, and an OFAC sanctions flag indicating whether the address appears on the US Treasury sanctions list — all in a single structured response.

## 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": {
      "chain": {
       "type": "string",
       "description": "base | ethereum | optimism | arbitrum | polygon | gnosis (default base)"
      },
      "address": {
       "type": "string",
       "description": "Wallet address (0x + 40 hex), e.g. '0xd8dA6BF...6045' (vitalik.eth)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "chain": "ethereum",
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  },
  "cached": false,
  "native": {
   "amount": 1234.5,
   "symbol": "ETH",
   "price_usd": 2400,
   "value_usd": 2962800
  },
  "source": "Blockscout + DexScreener + OFAC sanctioned-address list",
  "holdings": [
   {
    "name": "USD Coin",
    "type": "ERC-20",
    "amount": 50000,
    "symbol": "USDC",
    "contract": "0xa0b8...eb48",
    "price_usd": 1,
    "value_usd": 50000
   }
  ],
  "portfolio": {
   "token_count": 42,
   "total_value_usd": 5200000,
   "priced_token_count": 18
  },
  "timestamp": "2026-06-26T16:00:00Z",
  "disclaimer": "Balances/valuations are best-effort from public indexers; OFAC list may lag. Not advice.",
  "risk_flags": [],
  "sanction_check": {
   "source": "OFAC SDN crypto addresses",
   "list_loaded": true,
   "ofac_listed": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wallet-x-ray-on-chain-portfolio-risk-analysis-bbc91281/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-endpoints.onrender.com](https://www.zero.xyz/host/x402-endpoints.onrender.com/llms.txt)