Price of a token at a given timestamp.
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 Granularity | Default Staleness Tolerance |
---|---|
15s | 60s |
1m | 5m |
5m | 10m |
1h | 2h |
1d | 2d |
input_timestamp
: The requested timestamp in the payloadprice_timestamp
: The timestamp of the latest price found for the tokenSuccessful Response
The response is of type object
.