---
title: "Token Prices History"
method: POST
path: "/api/v1/developer/prices/history"
tags: ["PRICES", "DEVELOPER"]
---

# Token Prices History

`POST /api/v1/developer/prices/history`

Get a list of historical token prices by chain and token address for a given time range and granularity.

## Query parameters

- `cursor` string

## Request body

- PayloadPriceHistorical
  - `start_timestamp` string, date-time, required — Start of time range (UTC ISO 8601)
  - `end_timestamp` string, date-time, required — End of time range (UTC ISO 8601)
  - `addresses` PayloadTokenAddress[], required — List of token address+chain pairs
    - `token_address` string, required — Token contract address
    - `chain` string, required — Lowercase chain name
  - `time_granularity` '15s' | '1m' | '5m' | '1h' | '1d', required

## Response `200`

Successful Response

- EnvelopeUnionTokenPriceHistoricalTokenPrice
  - `items` union[], required — Response items
    - union
      - TokenPriceHistorical
        - `mint` string, required — Token contract address
        - `chain` string, required — Lowercase chain name
        - `decimals` integer, nullable — Token decimal places
        - `prices` TokenPriceHistoricalItem[], required — OHLCV candle array, one entry per time interval
          - `timestamp` string, date-time, required — ISO 8601 UTC candle start time
          - `price` number, required — Volume-weighted average price (USD) over the interval
          - `open` number, required — Opening price (USD) at the start of the interval
          - `high` number, required — Highest price (USD) during the interval
          - `close` number, required — Closing price (USD) at the end of the interval
          - `low` number, required — Lowest price (USD) during the interval
      - TokenPrice
        - `timestamp` string, date-time, required
        - `chain` string, required
        - `mint` string, required
        - `decimals` integer, nullable
        - `price` number, required
        - `open` number, required
        - `high` number, required
        - `close` number, required
        - `low` number, required
        - `volume_24h` number, nullable
        - `volume_1h` number, nullable
        - `trade_count_24h` integer, nullable
        - `trade_count_1h` integer, nullable
  - `cursor` string, nullable — Pagination cursor for next page
  - `message` string, nullable — Informational message (e.g. partial results)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)