# Allium At Timestamp Token Prices

> Allium At Timestamp Token Prices 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 token prices at or near a specific historical timestamp for one or more tokens across multiple chains

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/developer/prices/at-timestamp?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-at-timestamp-4d1409af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_md8QkE-89jQzu4_SOox1q

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-at-timestamp-4d1409af -d '<json body>'
```

Example prompt: What were the prices of USDC on Ethereum (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and wrapped SOL on Solana (So11111111111111111111111111111111111111112) on March 15, 2024 at 2:30pm UTC — snap to the nearest 1-hour bucket?

## When to prefer this

Use this endpoint when you need the price of one or more tokens at a specific historical moment in time, such as for PnL calculations, portfolio valuations at a past date, or reconstructing trade values. Prefer this over the History endpoint when you want a single point-in-time price rather than a time series, and over the Prices endpoint when you need historical rather than current prices. Supports multiple chains and tokens in a single request, making it efficient for cross-chain portfolio snapshots.

## Known failure modes

- Token address not recognized or not indexed — returns empty items array for that token
- Timestamp too far in the past or outside supported range — may return no price data
- Invalid chain identifier — validation error or empty result
- Unsupported time_granularity value — schema validation error
- Malformed ISO 8601 timestamp — request rejected with validation error
- Network or service unavailability — HTTP 5xx error

## How this service works

Get token prices at a specific time

## Output

An array of price records, each containing the token mint address, blockchain network, the requested input timestamp, the nearest snapped price timestamp (based on the chosen granularity), and the token price in USD at that time.

## Example request

```json
{
 "addresses": [
  {
   "chain": "ethereum",
   "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  },
  {
   "chain": "solana",
   "token_address": "So11111111111111111111111111111111111111112"
  }
 ],
 "timestamp": "2024-03-15T14:30: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"
     }
    }
   }
  },
  "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-at-timestamp-4d1409af/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)