# Base USDC Transfer History Lookup

> Base USDC Transfer History Lookup is a paid API for AI agents from apiacre.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Retrieves newest-first incoming and outgoing Circle USDC ERC-20 Transfer events for a given Ethereum address over a bounded block range on Base mainnet.

## Facts

- Endpoint: POST https://apiacre.com/v1/crypto/base-usdc-transfers
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-usdc-transfer-history-lookup-bbd66973
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MQPODZjsYGcBWm_WmCQPN

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 base-usdc-transfer-history-lookup-bbd66973 -d '<json body>'
```

Example prompt: Can you pull all USDC transfers for the Base mainnet address 0xAbCd...1234 over the last 2000 blocks, showing both incoming and outgoing, so I can verify a recent payment?

## When to prefer this

Choose this endpoint when you need verified, on-chain USDC transfer event history specifically on Base mainnet for a single address, bounded to a recent block range. It is ideal for payment verification, treasury reconciliation, or agent-payment confirmation workflows where Circle's native USDC contract is the only asset of interest. Prefer this over general block explorers when you need structured, machine-readable JSON output with direction filtering and atomic/human amounts in one call. Not suitable for complete historical account sweeps, other EVM chains, or non-USDC tokens.

## Known failure modes

- Invalid or malformed Ethereum address returns a validation error
- Block range exceeds the bounded maximum (2000 blocks) returns an error
- Unsupported block tag or out-of-range block number returns an error
- Public Base RPC unavailability causes a timeout or upstream error
- Address with no USDC transfers in range returns an empty transfers array
- Non-Base mainnet addresses or wrong chain return no results or an error

## How this service works

Retrieve newest-first incoming and outgoing Circle USDC Transfer events for one address across a validated, bounded Base mainnet block range.

## Output

A JSON object containing: asset metadata (USDC name, symbol, contract, decimals), the queried address, network (eip155:8453), transfer direction, a list of transfer events each with to/from addresses, amounts in human-readable USDC and atomic units, block number, transaction hash, log index, and a Basescan explorer URL. Also includes block range details (fromBlock, toBlock, timestamps, scanned block count), truncation flag, warnings, RPC call count, and disclaimer/limitation notices.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "address": {
   "type": "string"
  },
  "block_tag": {
   "enum": [
    "latest",
    "safe",
    "finalized"
   ],
   "type": "string"
  },
  "direction": {
   "enum": [
    "any",
    "incoming",
    "outgoing"
   ],
   "type": "string"
  },
  "lookback_blocks": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "asset": {
    "name": "USD Coin",
    "symbol": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "decimals": 6
   },
   "source": "https://docs.base.org/base-chain/api-reference/ethereum-j...",
   "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4...",
   "address": "0x1111111111111111111111111111111111111111",
   "network": "eip155:8453",
   "detected": 1,
   "readOnly": true,
   "returned": 1,
   "warnings": [],
   "direction": "any",
   "transfers": [
    {
     "blockHash": "0x2222222222222222222222222222222222222222222222222222222...",
     "blockNumber": 34567800,
     "transactionHash": "0x3333333333333333333333333333333333333333333333333333333...",
     "transactionIndex": 4
    }
   ],
   "truncated": false,
   "blockRange": {
    "toBlock": 34567890,
    "fromBlock": 34565891,
    "toBlockHash": "0x1111111111111111111111111111111111111111111111111111111...",
    "requestedTag": "safe"
   },
   "disclaimer": "Public onchain event evidence only. A transfer does not e...",
   "usdcSource": "https://developers.circle.com/stablecoins/usdc-contract-a...",
   "limitations": [
    "Only Circle's official native USDC contract on Base mainn...",
    "The result covers only the resolved bounded block range, ...",
    "Finality and provider freshness depend on the requested b..."
   ],
   "tokenSource": "https://eips.ethereum.org/EIPS/eip-20",
   "rpcCallsMade": 3,
   "eventSignature": "Transfer(address,address,uint256)",
   "removedSkipped": 0,
   "queriedLogCount": 1,
   "duplicatesRemoved": 0,
   "addressExplorerUrl": "https://basescan.org/address/0x11111111111111111111111111...",
   "networkRequestsMade": 2,
   "transactionBroadcast": false
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": []
  },
  "service": "crypto.base-usdc-transfers",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-usdc-transfer-history-lookup-bbd66973/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)