# Allium Historical Token Prices

> Allium Historical Token Prices is a paid API for AI agents from agents.allium.so, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Retrieves historical price data for onchain tokens over a specified time range

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/developer/prices/history
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-allium-so-72d59a50
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YZoyzEIvA2XyJcnuDtvT7

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 agents-allium-so-72d59a50 -d '<json body>'
```

Example prompt: Pull the historical price data for ETH on Ethereum from January 1 2024 to March 31 2024 using Allium — I need daily prices to calculate PnL.

## When to prefer this

Use this endpoint when you need a time series of token prices over a historical period — for PnL calculations, backtesting, charting, or auditing past portfolio values. Prefer this over the 'At Timestamp' endpoint when you need multiple price points across a range rather than a single snapshot, and over the 'latest prices' endpoint when you need past rather than current data.

## Known failure modes

- Unknown token symbol or address returns 404 or empty result
- Invalid date range or malformed timestamps return 400 error
- Unsupported chain returns error or empty dataset
- Payment of 0.02 USDC not completed triggers 402 payment required
- Rate limiting or quota exceeded returns 429
- Date range too large may result in timeout or truncated results

## How this service works

API request: /api/v1/developer/prices/history

## Output

Returns a time series of historical token prices for the requested asset, including price values and associated timestamps over the specified range, suitable for charting, PnL calculations, or trend analysis.

## 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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "mint": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "chain": "ethereum",
    "prices": [
     {
      "low": 2493,
      "high": 2505,
      "open": 2495,
      "close": 2500.5,
      "price": 2500.5,
      "timestamp": "2025-06-17T10:00:00Z"
     }
    ],
    "decimals": 18
   }
  ]
 }
}
```

## More

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