# Allium Token Price Statistics

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

Returns statistical aggregates (min, max, average, volatility, etc.) for token prices over a specified period

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/developer/prices/stats
- Price: $0.02/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-allium-so-e2c8cd89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bkNVAi0a1HtzGMHhUiMLe

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

Example prompt: Can you pull the price statistics for WBTC on Ethereum over the past 30 days — I want to see the min, max, average, and any volatility measures Allium has?

## When to prefer this

Use this endpoint when you need aggregated statistical summaries of token prices over a time window (e.g., volatility, average, min/max) rather than a single point-in-time price or a full price history series. Prefer this over the 'Get latest token prices' endpoint when historical statistical analysis is needed, and over raw SQL queries when you specifically need price statistics without writing custom SQL.

## Known failure modes

- Invalid or unrecognized token identifier returns 400 error
- Unsupported chain returns 400 or empty result
- Time range outside available data coverage returns empty or partial stats
- Missing required body parameters returns 422 validation error
- Payment failure via x402 protocol returns 402 Payment Required
- Rate limiting or quota exceeded returns 429

## How this service works

Get token price statistics

## Output

Returns computed price statistics for the specified token(s) and time window, including aggregates such as minimum price, maximum price, mean price, price change percentage, and volatility metrics derived from onchain price data.

## Example request

```json
[
 {
  "chain": "ethereum",
  "token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
 }
]
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "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"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "mint": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "chain": "ethereum",
    "low_1h": 2480,
    "high_1h": 2520,
    "low_24h": 2400,
    "decimals": 18,
    "high_24h": 2600,
    "timestamp": "2025-06-17T18:00:00Z",
    "latest_price": 2500.5,
    "percent_change_1h": 0.8,
    "percent_change_24h": 2.5
   }
  ]
 }
}
```

## More

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