Fetch token price history

Get the price history for the given token and the given time granularity.

POST /api/v1/developer/prices/history

Token Prices History

cURL

curl --request POST \
  --url https://api.allium.so/api/v1/developer/prices/history \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "addresses": [
    {
      "chain": "string",
      "token_address": "string"
    },
    {
      "chain": "string",
      "token_address": "string"
    }
  ],
  "end_timestamp": "2025-03-07T01:00:00Z",
  "start_timestamp": "2025-03-07T00:00:00Z",
  "time_granularity": "5m"
}
'

200

{
  "items": [
    {
      "mint": "<string>",
      "chain": "<string>",
      "prices": [
        {
          "timestamp": "2023-11-07T05:31:56Z",
          "price": 123,
          "open": 123,
          "high": 123,
          "close": 123,
          "low": 123
        }
      ],
      "decimals": 123
    }
  ],
  "cursor": "<string>",
  "message": "<string>"
}

This endpoint returns the price and OHLC for a list of tokens/chains in a given time window. Prices are calculated as a volume-weighted average and OHLC values are aggregated over DEX trades within the window specified by time_window.

Max number of tokens per request: 50

Supported Windows

The following are the supported time windows and their associated retention periods:

Window	Retention
15s	5 days
1m	All
5m	All
1h	All
1d	All

Supported Chains

Edge Cases

Forward-filled prices

If a token has no trading activity in a requested time window, we will forward fill the price and OHLC from the most recent prior window with data (i.e., carry forward the last known values) so your time series is more consistent/dense.

Notes:

• If there is no prior datapoint to forward fill from before the start of the requested time window (e.g. if the token was not created yet), that window will still have no data.

Incomplete Time Windows

This endpoint returns price data for the current time window, even if it’s incomplete. For example:

• If the API is called at 10:30, the latest hourly datapoint for 10:00 is based on trades from 10:00 to 10:30
• If called at 11:00, the 10:00 datapoint will be finalized, reflecting a full hour of trades (i.e., 10:00 to 11:00)

Users should account for this when handling near-realtime data.

Authorizations

X-API-KEY · string · header · required

Query Parameters

cursor · string

Body

application/json

PayloadPriceHistorical

PayloadPriceHistoricalLegacy

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 · object[] · required

List of token address+chain pairs

Show child attributes

time_granularity · enum<string> · required

Candle granularity (15s, 1m, 5m, 1h, 1d)

Available options: 15s, 1m, 5m, 1h, 1d

Response

200

application/json

Successful Response

items · (TokenPriceHistorical · object | TokenPrice · object)[] · required

Response items

TokenPriceHistorical

TokenPrice

Show child attributes

cursor · string | null

Pagination cursor for next page

message · string | null

Informational message (e.g. partial results)