# BlockRun.AI Wallet Transfer History

> BlockRun.AI Wallet Transfer History is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.0085/call, status unknown (last checked 2026-09-14).

Retrieves the transfer history for a given blockchain wallet address.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/surf/wallet/transfers
- Price: $0.0085/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-wallet-transfer-history-b384ab4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DzoUwZE0GVFvvURvkJRYo

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 blockrun-ai-wallet-transfer-history-b384ab4f
```

Example prompt: Can you pull up the full transfer history for this wallet address: 0x742d35Cc6634C0532925a3b8D4C9B7D8E5f1234?

## When to prefer this

Use this endpoint when you need on-chain wallet transfer history and are already working within the BlockRun.AI ecosystem (e.g., alongside Polymarket positions or DeFi protocol data). Ideal for DeFi analytics, wallet auditing, or tracking smart money movements across a specific address.

## Known failure modes

- Missing or invalid wallet address returns an error
- Non-existent or unindexed address returns empty results
- Malformed address format causes a 400 Bad Request
- Rate limiting or payment failure returns 402 Payment Required
- Network-specific addresses may not be supported

## How this service works

Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.

## Output

A list of transfer events associated with the specified wallet address, including token transfers in and out, counterparty addresses, amounts, and transaction metadata such as timestamps and transaction hashes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "Required query param"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-wallet-transfer-history-b384ab4f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)