# agent402.tools Wallet Asset Transfer History

> agent402.tools Wallet Asset Transfer History is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns the most recent asset transfers (native coin, ERC-20, ERC-721, ERC-1155) for a wallet address, merged and sorted newest-first with block, tx hash, counterparty, asset, and decimal value.

## Facts

- Endpoint: POST https://agent402.tools/api/wallet-transactions
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-wallet-asset-transfer-history-08f1f48b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OX8rBpngcqPto-IcA_sMY

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 agent402-tools-wallet-asset-transfer-history-08f1f48b -d '<json body>'
```

Example prompt: Can you pull the last 50 asset transfers — both incoming and outgoing — for wallet 0xAbCd...1234 on Ethereum, including native ETH, ERC-20s, and any NFTs?

## When to prefer this

Use this endpoint when you need a unified, multi-asset transfer history (native + ERC-20 + ERC-721 + ERC-1155) for a single wallet across major EVM chains, already sorted and merged — ideal for wallet auditing, portfolio tracking, or on-chain activity analysis without needing to query separate token-type endpoints.

## Known failure modes

- Invalid wallet address format (not 0x-prefixed 40-char hex) returns validation error
- Unsupported network name returns error — must be one of ethereum/base/polygon/arbitrum/optimism
- fromBlock in wrong format (non-hex) causes parse failure
- limit out of range (0 or >100) may return error or be clamped
- Payment of 0.002 USDC not sent or rejected causes 402 response
- Empty result set for wallets with no transfers on the specified network

## How this service works

Return the most recent asset transfers (incoming + outgoing) for a wallet address - native coin, ERC-20, ERC-721, ERC-1155 - already merged and sorted newest first. Each row carries the block, tx hash, counterparty, asset, and decimal value. Cap is 100 per direction; widen the window via `fromBlock` if you need deeper history.

## Output

A merged, newest-first list of up to N transfer records per direction, each containing the block number, transaction hash, counterparty address, asset name/contract, token type (native/ERC-20/ERC-721/ERC-1155), and decimal-formatted value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Max transfers per direction (1-100, default 25)."
  },
  "address": {
   "type": "string",
   "description": "0x-prefixed 40-char hex wallet address."
  },
  "network": {
   "type": "string",
   "description": "ethereum / base / polygon / arbitrum / optimism (default base)."
  },
  "fromBlock": {
   "type": "string",
   "description": "Optional starting block in hex (default 0x0 = earliest)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "limit": 10,
  "address": "0xabf4fabd7c416fb67202e5f9002389fc75e2a9d0",
  "network": "base",
  "transfers": [
   {
    "to": "0xabf…",
    "from": "0x…",
    "hash": "0xabc…",
    "asset": "USDC",
    "value": "0.001",
    "blockNum": 18250000,
    "category": "erc20",
    "direction": "in"
   }
  ]
 }
}
```

## More

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