---
title: "List Historical Prices"
method: GET
path: "/markets/{market}/historical-prices"
tags: ["Pricing"]
---

# List Historical Prices

`GET /markets/{market}/historical-prices`

Retrieves a set of average prices at a certain increment of time for the requested market.
This endpoint is suitable for retrieving historical average price trends where price precision, execution, and
other detailed information is not required.
To control the count, use either  `increment` or `max_data_points`.
List Historical Prices returns an error when an unexpected value is given, or when `increment` and
 `max_data_points` are both given or omitted.

When `range.begin` is omitted, the first data point shows the mid price, the average of the order book best bid
 and ask price, or the earliest available date. It is possible to set `range.begin` to a future date without error.

When `range.end` is omitted, the last data point will display current mid price (average of order book best bid
 and best ask) at the request timestamp. It is possible to set `range.end` to a future date without error.

When `pagination.limit` is omitted, the pagination limit will default to return the first 100 items.
If the pagination limit is set, the API will return up to the limit in one response. The pagination limit max is 1,000.

Time-series items are returned in chronological (ascending) order. All timestamps are in UTC.

## Path parameters

- `market` 'ETHEUR' | 'ETHUSD' | 'BTCEUR' | 'BTCUSD' | 'PAXGUSD' | 'BCHUSD' | 'LTCUSD' | 'ETHGBP' | 'BTCGBP' | 'LTCGBP' | 'BCHGBP' | 'USDPUSD' | 'ETHBRL' | 'BTCBRL' | 'LTCBRL' | 'BCHBRL' | 'USDPGBP' | 'USDPBRL' | 'LINKUSD' | 'AAVEUSD' | 'UNIUSD' | 'AAVEMXN' | 'BCHMXN' | 'BTCMXN' | 'ETHMXN' | 'LTCMXN' | 'USDPMXN' | 'AAVEEUR' | 'BCHEUR' | 'LTCEUR' | 'LINKEUR' | 'PAXGEUR' | 'SOLEUR' | 'USDPEUR' | 'UNIEUR' | 'PYUSDEUR' | 'PYUSDGBP' | 'PEPEUSD' | 'TRUMPUSD' | 'SHIBUSD' | 'ARBUSD' | 'BONKUSD' | 'ENAUSD' | 'MNTUSD' | 'ONDOUSD' | 'PENGUUSD' | 'QNTUSD' | 'RENDERUSD' | 'SKYUSD' | 'WIFUSD' | 'WLDUSD' | 'DOGEUSD' | 'AVAXUSD' | 'SUIUSD' | 'POLUSD' | 'XLMUSD' | 'BNBUSD', required

## Query parameters

- `max_data_points` integer
- `range.begin` string, date-time
- `range.end` string, date-time
- `pagination.limit` integer
- `pagination.offset` integer
- `increment` 'ONE_MINUTE' | 'FIVE_MINUTES' | 'FIFTEEN_MINUTES' | 'THIRTY_MINUTES' | 'ONE_HOUR' | 'TWO_HOURS' | 'TWELVE_HOURS' | 'ONE_DAY' | 'ONE_WEEK' | 'TWO_WEEKS' | 'FOUR_WEEKS'

## Response `200`

A successful response.

- ListHistoricalPricesResponse
  - `total_count` integer
  - `items` HistoricalPrice[] — List of historical prices.
    - `average_price` string, decimal — Time-weighted average price over the specified time period, beginning at the defined timestamp. For example, if `increment` is set to `ONE_HOUR`, then `average_price` is the time-weighted average for an hour. The entire time period must be completed to display results.
    - `timestamp` string, date-time — Timestamp at the beginning of an increment.

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/revisions/0687ca8c9a8d/schema)