# BRAINIAC Wallet Intelligence — Transfer History

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

Fetches and aggregates ERC-20 token transfer history for a given wallet address on Base, including incoming/outgoing flows and net balances by token.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/wallet-intelligence/transfers?utm_source=zero.xyz
- Price: $0.05/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-transfer-history-88295e78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dv6JvaC1HXI1Q3-f7hz9e

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-transfer-history-88295e78 -d '<json body>'
```

Example prompt: Pull the token transfer history for wallet 0x1234567890123456789012345678901234567890 on Base, looking at USDC (0x833589fcd6edb6e08f4c7c32d4f71b54ba029339b) transfers between blocks 18000000 and 18001000, and show me the incoming, outgoing, and net flows.

## When to prefer this

Choose this endpoint when you need on-chain token transfer history specifically on the Base network and want structured net-flow aggregations (incoming, outgoing, net by token) alongside raw transfer records. It is ideal for wallet auditing, DeFi accounting, and counterparty analysis when you already know the token contract addresses of interest. Prefer alternatives if you need full transaction history across all tokens without pre-specifying contracts, need data from chains other than Base, or require more than 10,000 blocks of history in a single call.

## Known failure modes

- Block range exceeds 10,000 blocks — response will note the limitation and may return partial data
- Token addresses not supplied — only explicitly provided token contracts are scanned, so unknown tokens will be missed
- Invalid wallet address format (not a 0x hex address) — schema validation error
- Invalid or non-existent block numbers — may return empty transfer list
- Limit too low — results may be truncated if transfer count exceeds limit parameter
- Network unavailability of Base JSON-RPC — retrieval error in sources array

## 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 individual transfer records (with to/from addresses, value, txHash, timestamp, block number, direction), aggregated incoming and outgoing totals by token address, net flow per token, unique counterparties, unique token contracts seen, the scanned block range, and metadata about data sources and limitations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 100,
   "maximum": 1000,
   "minimum": 1
  },
  "toBlock": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0
  },
  "fromBlock": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0
  },
  "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": {
  "sources": [
   {
    "url": "https://mainnet.base.org",
    "source": "Base JSON-RPC",
    "retrievedAt": "2026-10-29T12:00:00.000Z"
   }
  ],
  "toBlock": 18001000,
  "incoming": {
   "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913": "100000000"
  },
  "netFlows": [
   {
    "net": "100000000",
    "incoming": "100000000",
    "outgoing": "0",
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
   }
  ],
  "outgoing": {},
  "fromBlock": 18000000,
  "transfers": [
   {
    "to": "0x1234567890123456789012345678901234567890",
    "from": "0xabcdef1234567890abcdef1234567890abcdef12",
    "value": "100000000",
    "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "direction": "incoming",
    "timestamp": "2026-10-29T12:00:00.000Z",
    "blockNumber": 18000500,
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
   }
  ],
  "limitations": [
   "Block range is limited to 10000 blocks.",
   "Transfers are limited to explicitly supplied token addresses.",
   "Does not claim complete wallet transaction history."
  ],
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "currentBlock": 18001000,
  "transferCount": 1,
  "walletAddress": "0x1234567890123456789012345678901234567890",
  "scannedBlockRange": "18000000-18001000",
  "uniqueCounterparties": [
   "0xabcdef1234567890abcdef1234567890abcdef12"
  ],
  "uniqueTokenContracts": [
   "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-wallet-intelligence-transfer-history-88295e78/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)
