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

# List Historical Candles

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

Returns OHLCV Candlesticks data for the given market.
To control the count, use either  `increment` or `max_data_points`.
List Historical Candles returns an error when an unexpected value is given, or when `increment` and
 `max_data_points` are both given or omitted.

When `range.end` is omitted, it will default to the current UTC timestamp.
It is possible to set `range.end` to a future date without error.

Omitting `range.begin` defaults it to six months before `range.end`.

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

Time-series items are in descending order. All timestamps are in UTC.

Markets that are not yet available will return a 400 error.

## 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
- `limit` integer
- `order` 'DESC' | 'ASC'
- `page_cursor` string
- `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.

- PublicListHistoricalCandlesResponse
  - `market` 'ETHUSD' | 'BTCUSD' | 'PAXGUSD' | 'BCHUSD' | 'LTCUSD' | 'USDPUSD' | 'LINKUSD' | 'AAVEUSD' | 'UNIUSD' | 'PEPEUSD' | 'TRUMPUSD' | 'SHIBUSD' | 'ARBUSD' | 'BONKUSD' | 'ENAUSD' | 'MNTUSD' | 'ONDOUSD' | 'PENGUUSD' | 'QNTUSD' | 'RENDERUSD' | 'SKYUSD' | 'WIFUSD' | 'WLDUSD' | 'DOGEUSD' | 'AVAXUSD' | 'SUIUSD' | 'POLUSD' | 'XLMUSD' | 'BNBUSD'
  - `increment` 'ONE_MINUTE' | 'FIVE_MINUTES' | 'FIFTEEN_MINUTES' | 'THIRTY_MINUTES' | 'ONE_HOUR' | 'TWO_HOURS' | 'TWELVE_HOURS' | 'ONE_DAY' | 'ONE_WEEK' | 'TWO_WEEKS' | 'FOUR_WEEKS'
  - `items` PublicCandlestickPrice[] — List of historical candles.
    - `timestamp` string, date-time
    - `open` string, decimal
    - `high` string, decimal
    - `low` string, decimal
    - `close` string
    - `volume` string, decimal
  - `next_page_cursor` string — Cursor token required for fetching the next page.

## Other responses

- `400` — Bad Request

---

[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)