# BaseLens Recent Transfers

> BaseLens Recent Transfers is a paid API for AI agents from baselens-api.vercel.app, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-31).

Retrieves recent ERC-20 token transfer history for a Base blockchain address, filterable by token contracts and block range

## Facts

- Endpoint: GET https://baselens-api.vercel.app/v1/transfers?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/baselens-recent-transfers-d93cc0d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PJlYojb2T9yX0OgCvg1Ir

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 baselens-recent-transfers-d93cc0d2
```

Example prompt: Show me the last 50 USDC transfers for Base address 0x4B5c…34F6, looking back up to 10000 blocks.

## When to prefer this

Choose this endpoint when you need paginated, filterable ERC-20 transfer history for a specific Base address without an API key, and you want pay-per-call pricing at $0.004 USDC per request. It is ideal for AI agents that need lightweight on-chain forensics, wallet auditing, or DeFi activity tracking on Base L2 without setting up a full blockchain indexer or managing API credentials.

## Known failure modes

- Missing required 'address' parameter returns a 400 error
- Invalid or non-0x-prefixed address format causes a validation error
- Requesting more than 200 transfers returns an error or is capped
- Block lookback exceeding 30000 is rejected or clamped
- Specifying more than 5 token contracts in the filter returns an error
- Payment not provided or insufficient USDC triggers a 402 Payment Required response
- No transfers found in the specified block range returns an empty transfers array

## How this service works

Base address, ERC-20 balance, token price, recent transfers, Basename/ENS resolve, contract verification, tx summaries and gas over x402 and MCP. $0.001–$0.004 USDC per call, no API key.

## Output

Returns a JSON object containing the queried address, the number of transfers returned, and an array of transfer records each including the counterparty address, transaction hash, block number, token amount, token symbol, and direction (in/out), plus a totalFound count indicating how many transfers matched the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Max transfers to return, ≤200 (default 50)"
      },
      "blocks": {
       "type": "string",
       "description": "Lookback in blocks, 100–30000 (default 10000)"
      },
      "tokens": {
       "type": "string",
       "description": "Optional comma-separated token contracts (max 5). Default USDC."
      },
      "address": {
       "type": "string",
       "description": "0x-prefixed Base address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "address": "0x4B5c…34F6",
  "returned": 5,
  "transfers": [
   {
    "to": "0xB706…82a3",
    "tx": "0x…",
    "block": 53290131,
    "amount": "23",
    "symbol": "USDC",
    "direction": "out"
   }
  ],
  "totalFound": 12
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/baselens-recent-transfers-d93cc0d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from baselens-api.vercel.app](https://www.zero.xyz/host/baselens-api.vercel.app/llms.txt)