# Wallet historical balances API

Historical balances of any 0x address on Base: ETH and the main tokens (USDC, WETH, cbBTC, DAI, USDbC, cbETH, AERO, EURC, plus up to 5 more) read at one block per day for up to 30 days, with ETH priced from the on-chain Uniswap pool at each date and the USD value change. Use to see how a wallet's holdings moved, check a balance on a past date, or chart a treasury.

## Historical balances, wallet history

Historical balances, wallet history. $0.01 per successful call; failed calls are never charged.

Historical balances of any 0x address on Base: ETH and the main tokens (USDC, WETH, cbBTC, DAI, USDbC, cbETH, AERO, EURC, plus up to 5 more) read at one block per day for up to 30 days, with ETH priced from the on-chain Uniswap pool at each date and the USD value change. Use to see how a wallet's holdings moved, check a balance on a past date, or chart a treasury.

Inputs: address (required): 0x wallet or contract address on Base; days: How many days back, one point per day (1-30, default 7); tokens: Optional extra token addresses on Base, comma-separated (up to 5).

Free first (25 successful calls per caller, no key):

    curl "https://agent-data-tools.revmesh2074.workers.dev/wallet/balance-history?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&trial=1"

With a card key from https://agent-data-tools.revmesh2074.workers.dev/credits, in a header or, when your client can only fetch a URL, in the URL:

    curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/wallet/balance-history?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    curl "https://agent-data-tools.revmesh2074.workers.dev/wallet/balance-history?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&api_key=adt_…"

Without a key the same URL answers 402 with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://agent-data-tools.revmesh2074.workers.dev/mcp) this tool is wallet_balance_history.

Example result:

    {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "chain": "Base",
      "chainId": 8453,
      "days": 1,
      "points": [
        {
          "date": "2026-11-04",
          "block": 37900000,
          "eth": "0.5",
          "tokens": {
            "USDC": "120.5"
          },
          "ethUsd": 3500.12,
          "valueUsd": 1870.56
        },
        {
          "date": "2026-11-05",
          "block": 37943200,
          "eth": "0.4",
          "tokens": {
            "USDC": "480.5"
          },
          "ethUsd": 3550.4,
          "valueUsd": 1900.66
        }
      ],
      "change": {
        "valueUsd": 30.1,
        "percent": 1.61
      },
      "tokensChecked": [
        "USDC",
        "WETH",
        "cbBTC",
        "DAI",
        "USDbC",
        "cbETH",
        "AERO",
        "EURC"
      ],
      "note": "Balances read at one block per day (Base makes a block every 2 s). valueUsd counts ETH, WETH, USDC and USDbC only."
    }

Tool page: https://agent-data-tools.revmesh2074.workers.dev/tools/wallet-balance-history

## Wallet transactions, history

Wallet transactions, history. $0.01 per successful call; failed calls are never charged.

Recent token transactions of any 0x address across every ERC-20 it holds: the newest 50 transfers in or out over recent blocks, each with token symbol, amount, counterparty, direction, block and transaction hash. Live Transfer logs on Base (default), Ethereum, Arbitrum, Optimism or Polygon; native-coin transfers are not included. Use to see what a wallet did lately, confirm a payment in any token, or audit activity before a deal.

Inputs: address (required): 0x wallet or contract address; chain: Network: base (default), eth, arb, op or polygon; blocks: How many recent blocks to scan (100-10000, default 2000; Base and Optimism make a block every 2 s, so 2,000 is about 67 minutes; Ethereum every 12 s).

Free first (25 successful calls per caller, no key):

    curl "https://agent-data-tools.revmesh2074.workers.dev/wallet/transactions?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&trial=1"

With a card key from https://agent-data-tools.revmesh2074.workers.dev/credits, in a header or, when your client can only fetch a URL, in the URL:

    curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/wallet/transactions?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    curl "https://agent-data-tools.revmesh2074.workers.dev/wallet/transactions?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&api_key=adt_…"

Without a key the same URL answers 402 with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://agent-data-tools.revmesh2074.workers.dev/mcp) this tool is wallet_transactions.

Example result:

    {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "chain": "Base",
      "chainId": 8453,
      "fromBlock": 123454790,
      "toBlock": 123456789,
      "count": 1,
      "truncated": false,
      "transfers": [
        {
          "block": 123456700,
          "tx": "0x…",
          "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "symbol": "USDC",
          "direction": "out",
          "counterparty": "0x2074c40346ae2a90e0e4a391bcee6f16bf5277f5",
          "amount": "1.5",
          "raw": "1500000"
        }
      ],
      "coverage": "all ERC-20 tokens",
      "note": "ERC-20 Transfer logs only; native-coin transfers are not included."
    }

Tool page: https://agent-data-tools.revmesh2074.workers.dev/tools/wallet-transactions

## Related wallets, counterparties

Related wallets, counterparties. $0.01 per successful call; failed calls are never charged.

Related wallets of a 0x address: who it sent ERC-20 tokens to or got them from over recent blocks, ranked by transfers, with sent and received counts, tokens, USDC in and out, first and last block, and wallet or contract. Live Transfer logs on Base (default), Ethereum, Arbitrum, Optimism or Polygon; native-coin transfers are not included. Use to map who a wallet trades with, find linked wallets before paying, or trace where funds went.

Inputs: address (required): 0x wallet or contract address; chain: Network: base (default), eth, arb, op or polygon; blocks: How many recent blocks to scan (100-10000, default 2000; Base and Optimism make a block every 2 s, so 2,000 is about 67 minutes; Ethereum every 12 s).

Free first (25 successful calls per caller, no key):

    curl "https://agent-data-tools.revmesh2074.workers.dev/wallet/related?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&trial=1"

With a card key from https://agent-data-tools.revmesh2074.workers.dev/credits, in a header or, when your client can only fetch a URL, in the URL:

    curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/wallet/related?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    curl "https://agent-data-tools.revmesh2074.workers.dev/wallet/related?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&api_key=adt_…"

Without a key the same URL answers 402 with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://agent-data-tools.revmesh2074.workers.dev/mcp) this tool is wallet_related.

Example result:

    {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "chain": "Base",
      "chainId": 8453,
      "fromBlock": 123454790,
      "toBlock": 123456789,
      "transfersScanned": 2,
      "truncated": false,
      "counterparties": [
        {
          "address": "0x2074c40346ae2a90e0e4a391bcee6f16bf5277f5",
          "kind": "wallet",
          "transfers": 2,
          "sent": 1,
          "received": 1,
          "tokens": [
            "USDC"
          ],
          "usdcSent": "1.5",
          "usdcReceived": "0.25",
          "firstBlock": 123452001,
          "lastBlock": 123456700
        }
      ],
      "coverage": "all ERC-20 tokens",
      "note": "ERC-20 Transfer logs only; native-coin transfers are not included."
    }

Tool page: https://agent-data-tools.revmesh2074.workers.dev/tools/wallet-related

## Questions

Docs for agents: https://agent-data-tools.revmesh2074.workers.dev/llms.txt · OpenAPI: https://agent-data-tools.revmesh2074.workers.dev/openapi.json · All guides: https://agent-data-tools.revmesh2074.workers.dev/guides