# Allium Historical Token Price Series

> Allium Historical Token Price Series is a paid API for AI agents from Allium at agents.allium.so, paid per call via MPP or x402, $0.02/call, status unknown (last checked 2026-10-12).

Returns a time-series of historical token prices for one or more tokens across specified blockchains, bucketed by a chosen time granularity

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/developer/prices/history?utm_source=zero.xyz
- Price: $0.02/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-d97863ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_emizsGiH803GYXWIRLkTH

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-d97863ee -d '<json body>'
```

Example prompt: Can you pull the hourly price history for USDC on Ethereum (contract 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) from January 1, 2025 to January 31, 2025 using 1-hour granularity?

## When to prefer this

Use this endpoint when you need time-series price data for one or more tokens over a historical period with fine-grained control over time buckets (from 15 seconds to 1 day). Ideal for PnL calculations, charting, backtesting, and filling historical price gaps. Prefer over spot-price endpoints when you need a range rather than a single moment in time.

## Known failure modes

- Invalid or unsupported token contract address returns an error or empty series
- Unsupported chain identifier causes a validation error
- Start timestamp after end timestamp returns an error
- Requested time range too large for the chosen granularity may time out or return partial data
- Token not indexed by Allium returns empty results
- Malformed ISO 8601 timestamp causes a 400 bad request

## How this service works

Get historical token price series

## Output

A time-series array of price data points for each requested token, indexed by timestamp and bucketed according to the specified granularity (15s, 1m, 5m, 1h, or 1d), covering the requested time range across the specified chains.

## Example request

```json
{
 "addresses": [
  {
   "chain": "ethereum",
   "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  }
 ],
 "end_timestamp": "2025-01-31T23:59:59Z",
 "start_timestamp": "2025-01-01T00:00:00Z",
 "time_granularity": "1h"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addresses": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "token_address",
     "chain"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "description": "Blockchain network (e.g. ethereum, solana, base)"
     },
     "token_address": {
      "type": "string",
      "description": "Token contract address"
     }
    }
   }
  },
  "end_timestamp": {
   "type": "string",
   "format": "date-time",
   "description": "ISO 8601 timestamp"
  },
  "start_timestamp": {
   "type": "string",
   "format": "date-time",
   "description": "ISO 8601 timestamp"
  },
  "time_granularity": {
   "enum": [
    "15s",
    "1m",
    "5m",
    "1h",
    "1d"
   ],
   "type": "string",
   "description": "Time granularity for price buckets"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allium-history-d97863ee/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)