Skip to main content
POST
/
api
/
v1
/
developer
/
prices
/
at-timestamp
Get Prices At Timestamp
curl --request POST \
  --url https://api.allium.so/api/v1/developer/prices/at-timestamp \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "addresses": [
    {
      "chain": "string",
      "token_address": "string"
    },
    {
      "chain": "string",
      "token_address": "string"
    }
  ],
  "staleness_tolerance": "1h",
  "time_granularity": "5m",
  "timestamp": "2025-03-07T00:00:00Z"
}
'
{
  "items": [
    {
      "input_timestamp": "2023-11-07T05:31:56Z",
      "price_timestamp": "2023-11-07T05:31:56Z",
      "mint": "<string>",
      "chain": "<string>",
      "price": 123
    }
  ],
  "cursor": "<string>",
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.allium.so/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint returns the price of a token at or before a given timestamp. If the token doesn’t have a price at the given timestamp (because there weren’t any trades at that time), the price will be the price at the closest timestamp before the given timestamp. Use staleness_tolerance to specify the max lookback time for a price.

​
time_granularity

time_granularity is the size of the aggregation window over which we aggregate the price. It can be one of the following values: 15s, 1m, 5m, 1h, 1d. Examples:
  • If you request a price at 3:15 with 1h granularity, we will return the price at 3:00. Note that the price at 3:00 is the volume-weighted price of the token between 3:00 and 4:00.
  • If you request a price at 3:12 with 5m granularity, we will return the price at 3:10 (aggregating the price of the token between 3:10 and 3:15).

​
Retention Periods

Data at each granularity is retained for different periods. The following are the retention periods for each supported granularity:
GranularityRetention
15s5 days
1m30 days
5m30 days
1hAll
1dAll

​
staleness_tolerance

staleness_tolerance is an optional string containing a number of seconds, minutes, hours, or days. Use this value to define the max lookback time for a price. For example: 60s, 5m, 2h, 2d. Some lower volume tokens are often not traded for hours or days before trading starts again. In these instances, we do not return a price for periods of inactivity to prevent returning a stale price that doesn’t represent the actual value of a token. To customize this behavior, you can use staleness_tolerance to define the max lookback time for a price.

​
Default Values

Time GranularityDefault Staleness Tolerance
15s60s
1m5m
5m10m
1h2h
1d2d

​
Response

The response contains two timestamps:
  • input_timestamp: The requested timestamp in the payload
  • price_timestamp: The timestamp of the latest price found for the token

​
Pagination

This endpoint returns prices for up to 200 tokens in a single request.

​
Supported Chains

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
addresses
PayloadTokenAddress · object[]
required

List of token address+chain pairs

Required array length: 1 - 200 elements
​
timestamp
string<date-time>
required

Target timestamp (UTC ISO 8601)

​
time_granularity
enum<string>
required

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

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

Max lookback for price data (e.g. 1h, 30m)

Response

Successful Response

​
items
TokenPriceAtTimestamp · object[]
required

Response items

​
cursor
string | null

Pagination cursor for next page

​
message
string | null

Informational message (e.g. partial results)