Base USDC transfer history
Retrieve newest-first incoming and outgoing Circle USDC Transfer events for one address across a validated, bounded Base mainnet block range.
$0.005 USDCBasex402 v2POST
Endpoint
https://apiacre.com/v1/crypto/base-usdc-transfersSend the JSON body below. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header; an x402-compatible buyer signs the requirement and retries with PAYMENT-SIGNATURE.
Agent one-call path
Optional third-party AgentCash can inspect this route and handle the x402 retry. Its fetch command may automatically pay, so this example caps the call at exactly $0.005 USDC. Copying the command does not pay; review the local wallet and request before running it.
npx --yes agentcash@latest check https://apiacre.com/v1/crypto/base-usdc-transfers
npx --yes agentcash@latest fetch https://apiacre.com/v1/crypto/base-usdc-transfers \
--method POST \
--header 'content-type: application/json' \
--body '{"address":"0x1111111111111111111111111111111111111111","lookback_blocks":2000,"direction":"any","limit":25,"block_tag":"safe"}' \
--payment-protocol x402 \
--payment-network base \
--max-amount 0.005AgentCash CLI documentation · Official SDK and wallet-safety alternatives
Input example
{
"address": "0x1111111111111111111111111111111111111111",
"lookback_blocks": 2000,
"direction": "any",
"limit": 25,
"block_tag": "safe"
}Response shape
{
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "crypto.base-usdc-transfers",
"version": "1",
"data": {
"network": "eip155:8453",
"address": "0x1111111111111111111111111111111111111111",
"asset": {
"name": "USD Coin",
"symbol": "USDC",
"contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"decimals": 6
},
"blockRange": {
"requestedTag": "safe",
"fromBlock": 34565891,
"toBlock": 34567890,
"toBlockHash": "0x1111111111111111111111111111111111111111111111111111111111111111",
"toBlockTimestamp": "2026-08-10T16:00:00+00:00",
"requestedLookbackBlocks": 2000,
"scannedBlocks": 2000
},
"direction": "any",
"eventSignature": "Transfer(address,address,uint256)",
"topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"queriedLogCount": 1,
"detected": 1,
"returned": 1,
"truncated": false,
"duplicatesRemoved": 0,
"removedSkipped": 0,
"transfers": [
{
"blockNumber": 34567800,
"blockHash": "0x2222222222222222222222222222222222222222222222222222222222222222",
"transactionHash": "0x3333333333333333333333333333333333333333333333333333333333333333",
"transactionIndex": 4,
"logIndex": 7,
"from": "0x2222222222222222222222222222222222222222",
"to": "0x1111111111111111111111111111111111111111",
"direction": "incoming",
"amountAtomic": "12500000",
"amountUsdc": "12.5",
"explorerUrl": "https://basescan.org/tx/0x3333333333333333333333333333333333333333333333333333333333333333"
}
],
"networkRequestsMade": 2,
"rpcCallsMade": 3,
"readOnly": true,
"transactionBroadcast": false,
"warnings": [],
"limitations": [
"Only Circle's official native USDC contract on Base mainnet is queried.",
"The result covers only the resolved bounded block range, not complete account history.",
"Finality and provider freshness depend on the requested block tag and public Base RPC."
],
"addressExplorerUrl": "https://basescan.org/address/0x1111111111111111111111111111111111111111",
"source": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_getLogs",
"usdcSource": "https://developers.circle.com/stablecoins/usdc-contract-addresses",
"tokenSource": "https://eips.ethereum.org/EIPS/eip-20",
"disclaimer": "Public onchain event evidence only. A transfer does not establish identity, ownership, authorization, commercial purpose, compliance status, or current balance."
},
"meta": {
"duration_ms": 42,
"cached": false,
"sources": [],
"warnings": [],
"next_actions": []
}
}Try the payment challenge
curl -i -X POST 'https://apiacre.com/v1/crypto/base-usdc-transfers' \
-H 'content-type: application/json' \
--data '{"address":"0x1111111111111111111111111111111111111111","lookback_blocks":2000,"direction":"any","limit":25,"block_tag":"safe"}'