# Allium Wallet Balance History

> Allium Wallet Balance History is a paid API for AI agents from Allium at agents.allium.so, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns historical token balances for one or more wallet addresses across specified blockchains over a given time range

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/developer/wallet/balances/history?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: Allium
- Docs: https://docs.allium.so
- Website: https://allium.so
- Tags: blockchain, prices, tokens, wallet, balances, transactions, pnl, sql, explorer, solana, base, defi, data
- Canonical page: https://www.zero.xyz/c/allium-history-388124b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A4U7OT3ETNAm5Ae0voR0n

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 allium-history-388124b4 -d '<json body>'
```

Example prompt: Can you pull the historical token balances for the Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 from January 1 2024 to January 31 2024?

## When to prefer this

Use this endpoint when you need to understand how wallet balances changed over a historical period — for auditing, portfolio tracking, tax reporting, or analyzing past DeFi activity. Prefer this over the current Balances endpoint when point-in-time or time-series balance data is needed rather than live balances.

## Known failure modes

- Invalid or unsupported chain name returns an error
- Malformed wallet address causes a bad request response
- Start timestamp after end timestamp returns a validation error
- Very large time ranges may result in truncated responses
- Unsupported chain/address combinations return empty or error results

## How this service works

Get historical wallet balances

## Output

A time-series dataset of token balances held by the specified wallet address(es) on the given chain(s) between the start and end timestamps, including token identities and balance amounts at various points in time.

## Example request

```json
{
 "addresses": [
  {
   "chain": "ethereum",
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }
 ],
 "end_timestamp": "2024-01-31T23:59:59Z",
 "start_timestamp": "2024-01-01T00:00:00Z"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addresses": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "chain",
     "address"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "description": "Blockchain network (e.g. ethereum, solana, base)"
     },
     "address": {
      "type": "string",
      "description": "Wallet address"
     }
    }
   }
  },
  "end_timestamp": {
   "type": "string",
   "format": "date-time",
   "description": "ISO 8601 timestamp"
  },
  "start_timestamp": {
   "type": "string",
   "format": "date-time",
   "description": "ISO 8601 timestamp"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allium-history-388124b4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.allium.so](https://www.zero.xyz/host/agents.allium.so/llms.txt)