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>"
}
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. If you request a price at 3:15 at 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 at 5m granularity, we will return the price at 3:10 (aggregating the price of the token between 3:10 and 3:15). 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. The default values are as follows:
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

Response

200
application/json

Successful Response

The response is of type object.