# BRAINIAC Wallet Intelligence Snapshot

> BRAINIAC Wallet Intelligence Snapshot is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-15).

Returns a real-time snapshot of an Ethereum wallet's ETH and ERC-20 token balances with USD valuations on Base (chain 8453), sourced from Base JSON-RPC and DeFiLlama pricing.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/wallet-intelligence/snapshot?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-wallet-intelligence-snapshot-8c330cc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sRxTXtNKYjTvgWchS42hj

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 brainiac-wallet-intelligence-snapshot-8c330cc6 -d '<json body>'
```

Example prompt: What's the current ETH balance and USD value of wallet 0x1234567890123456789012345678901234567890 on Base, and also check the USDC balance at token contract 0x833589fcd6edb6e08f4c7c32d4f71b54ba029339b?

## When to prefer this

Use this endpoint when you need a fast, real-time snapshot of a single wallet's ETH and ERC-20 token balances with USD valuations specifically on the Base network (chain 8453). It is ideal when you need structured, priced portfolio data without building your own RPC + pricing pipeline. Prefer this over generic RPC calls when you also want USD conversion powered by DeFiLlama. Not suitable for multi-chain lookups, historical balance queries, or NFT holdings.

## Known failure modes

- Invalid wallet address format (not a valid 0x 40-hex-char address) causes validation failure
- Token addresses that are not valid ERC-20 contracts on Base return unpriced or empty balance entries
- Tokens not listed on DeFiLlama are marked as unpriced (unpriced: true) with no USD value
- DeFiLlama API unavailability results in missing or stale USD valuations
- More than 20 token addresses in the request exceeds the maxItems limit and is rejected
- Payment of $0.02 USDC via x402 required; missing or invalid payment results in 402 response

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object containing the chain ID (8453 for Base), the wallet's ETH balance in wei and formatted ETH, ETH price in USD, ETH USD value, an array of token balances (each with name, symbol, decimals, raw balance, formatted balance, price in USD, and USD value), a list of data sources with retrieval timestamps, known limitations, and the overall snapshot timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "walletAddress": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$"
  },
  "tokenAddresses": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^0x[a-fA-F0-9]{40}$"
   },
   "maxItems": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chainId": 8453,
  "sources": [
   {
    "url": "https://mainnet.base.org",
    "source": "Base JSON-RPC",
    "retrievedAt": "2026-10-29T12:00:00.000Z"
   },
   {
    "url": "https://api.llama.fi/prices/current",
    "source": "DeFiLlama",
    "retrievedAt": "2026-10-29T12:00:00.000Z"
   }
  ],
  "snapshot": {
   "ethBalance": "1000000000000000000",
   "ethPriceUsd": 2500,
   "ethUsdValue": 2500,
   "ethBalanceEth": 1,
   "tokenBalances": [
    {
     "name": "USD Coin",
     "symbol": "USDC",
     "balance": "500000000",
     "decimals": 6,
     "priceUsd": 1,
     "unpriced": false,
     "usdValue": 500,
     "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     "formattedBalance": 500
    }
   ]
  },
  "limitations": [
   "Token balances require explicit token contract addresses.",
   "USD valuations depend on DeFiLlama price availability.",
   "…"
  ],
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "walletAddress": "0x1234567890123456789012345678901234567890"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-wallet-intelligence-snapshot-8c330cc6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
