# Oblique Markets ERC-20 Transfer History

> Oblique Markets ERC-20 Transfer History is a paid API for AI agents from api.oblique.markets, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns paginated ERC-20 token transfer history for a Base wallet address, filterable by token, direction, and page

## Facts

- Endpoint: POST https://api.oblique.markets/api/v1/paid/wallet-transfers
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oblique-markets-erc-20-transfer-history-0bb9d922
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zE0w8dAB29A6riTGZOgnq

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 oblique-markets-erc-20-transfer-history-0bb9d922 -d '<json body>'
```

Example prompt: Pull all incoming USDC transfers to wallet 0xAbC123... on Base, showing the first 20 results, so I can see who's been sending me funds.

## When to prefer this

Choose this endpoint when you need structured, paginated ERC-20 transfer history for a specific Base wallet address with filtering by token contract and direction (in/out/all). Prefer it over a full wallet spy endpoint when you specifically want normalized historical transfer records rather than real-time surveillance or token balances. It is well-suited for accounting, auditing, and counterparty analysis workflows on the Base network.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain value (non-Base) is rejected by schema enum
- Offset beyond available records returns empty result set
- Payment failure via x402 blocks the request
- Token address filter with no matching transfers returns empty array
- Network timeout or Base RPC unavailability causes a service error

## How this service works

Use when an agent needs wallet transfers. Returns ERC-20 transfer history for one Base wallet, backed by the public Base transfer index: filter by token, direction and page, with normalized amounts, counterparties and timestamps; priced per bounded request $0.005/call via x402. $0.005.

## Output

An array of ERC-20 transfer records for the specified Base wallet, each including normalized token amounts, counterparty wallet addresses, token contract details, and block timestamps; results are paginated via limit/offset and filtered by direction and token as requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "base": {
   "type": "string"
  },
  "flow": {
   "enum": [
    "in",
    "out",
    "all"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer"
  },
  "chains": {
   "enum": [
    "base"
   ],
   "type": "string"
  },
  "offset": {
   "type": "integer"
  },
  "tokens": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "0x1111111111111111111111111111111111111111",
  "chain": "base",
  "count": 1,
  "source": "base.blockscout.com",
  "transfers": [
   {
    "id": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa_3",
    "type": "token_transfer",
    "chain": "base",
    "tokenId": "usdc",
    "blockHash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "toAddress": {
     "chain": "base",
     "address": "0x1111111111111111111111111111111111111111",
     "contract": false,
     "isUserAddress": false
    },
    "tokenName": "USD Coin",
    "unitValue": 1.25,
    "blockNumber": 33712501,
    "fromAddress": {
     "chain": "base",
     "address": "0x2222222222222222222222222222222222222222",
     "contract": false,
     "isUserAddress": false
    },
    "tokenSymbol": "USDC",
    "toIsContract": false,
    "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
    "historicalUSD": 1.25,
    "tokenDecimals": 6,
    "blockTimestamp": "2026-08-10T12:00:00Z",
    "fromIsContract": false,
    "transactionHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oblique-markets-erc-20-transfer-history-0bb9d922/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.oblique.markets](https://www.zero.xyz/host/api.oblique.markets/llms.txt)