Historical balances, wallet history

$0.01 per call · failed calls are never charged · no account or subscription: pay per call with a card key or USDC

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.

Guide: Wallet historical balances API

Run it free (25 free calls) Buy credits by card (from $1) Example result (JSON)

Try it with your own inputs

0x wallet or contract address on Base

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
address (required)string0x wallet or contract address on Base
daysintegerHow many days back, one point per day (1-30, default 7)
tokensstringOptional extra token addresses on Base, comma-separated (up to 5)

Request

Over HTTP, with a card key from /credits:

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

Or one of your 25 free calls, no key:

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

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

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."
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is wallet_balance_history, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools