# Onchain Expat Wallet Identity API

> Onchain Expat Wallet Identity API is a paid API for AI agents from x402.onchainexpat.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Looks up a blockchain wallet address to return its ENS name, labels, transaction activity, and risk assessment

## Facts

- Endpoint: POST https://x402.onchainexpat.com/api/x402-crypto/wallet-identity
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-onchainexpat-com-fe811520
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C6-HblIr001t0-kw3_HXU

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 x402-onchainexpat-com-fe811520 -d '<json body>'
```

Example prompt: Can you look up the identity profile for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want its ENS name, any known labels, recent activity, and a risk assessment?

## When to prefer this

Use this endpoint when you need a comprehensive identity profile of a specific blockchain wallet address, including ENS resolution, risk scoring, and known labels — especially useful before sending funds, evaluating a counterparty, or auditing a suspicious address. Prefer this over generic ENS resolvers when you also need risk and activity data in a single call.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Wallet with no on-chain history may return empty activity and no labels
- ENS resolution failure if ENS provider is unavailable
- Payment not received or insufficient USDC results in 402 response
- Unknown chain or unsupported address format returns an error

## How this service works

Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol

## Output

Returns structured data about the wallet including its ENS name (if any), human-readable labels (e.g. exchange, whale, hacker), on-chain activity summary, and a risk score or risk flags indicating whether the address is associated with malicious behavior, sanctions, or known entities.

## Example request

```json
{
 "chain": "ethereum",
 "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "Blockchain (default: ethereum)"
  },
  "address": {
   "type": "string",
   "description": "Wallet address (0x + 40 hex chars) or ENS name (e.g. 'vitalik.eth')"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "risk": {
     "type": "object",
     "description": "Risk assessment with score, level, and factors"
    },
    "chain": {
     "type": "string"
    },
    "tokens": {
     "type": "object",
     "description": "Token holdings count and top holdings"
    },
    "address": {
     "type": "string"
    },
    "balance": {
     "type": "object",
     "description": "Native token balance"
    },
    "activity": {
     "type": "object",
     "description": "Transaction activity summary"
    },
    "identity": {
     "type": "object",
     "description": "Identity info: ens_name, known_label, wallet_type, is_contract"
    },
    "explorer_url": {
     "type": "string",
     "description": "Link to view wallet on block explorer"
    }
   }
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-onchainexpat-com-fe811520/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.onchainexpat.com](https://www.zero.xyz/host/x402.onchainexpat.com/llms.txt)