---
title: "Market candles"
method: GET
path: "/timeseries/market-candles"
tags: ["Timeseries"]
---

# Market candles

`GET /timeseries/market-candles`

Returns candles for specified markets.<br/> Results are ordered by tuple `(market, time)`.<br/> To fetch the next page of results use `next_page_url` JSON response field.<br/> Coin Metrics derives candles directly from trades. Candles are only generated if there are trades in the underlying interval. Therefore, gaps in candles data through time are normal and to be expected. To construct gapless candles, the client should fill forward candles through time, setting the open, high, low, and close to the close of the previous candle, setting the vwap to the vwap of the previous candle, and setting the volume to zero.

## Query parameters

- `markets` string[], required
- `frequency` string
- `start_time` string
- `end_time` string
- `start_inclusive` boolean
- `end_inclusive` boolean
- `timezone` string
- `page_size` integer
- `paging_from` 'start' | 'end', PagingFrom
- `limit_per_market` integer
- `pretty` boolean
- `format` 'json' | 'json_stream' | 'csv'
- `next_page_token` string

## Response `200`

Time series of market candles.

- MarketCandlesResponse
  - `data` MarketCandle[], required
    - `market` string, required — Unique name of the market.
    - `time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `price_open` string, required — The opening price of the candle.
    - `price_close` string, required — The closing price of the candle.
    - `price_high` string, required — The high price of the candle.
    - `price_low` string, required — The low price of the candle.
    - `vwap` string, required — The volume-weighted average price of the candle.
    - `volume` string, required — The volume of the candle in units of the base asset.
    - `candle_usd_volume` string, required — The volume of the candle in USD.
    - `candle_trades_count` string, required — The number of trades used for candle calculation.
  - `next_page_token` string — Token of the next page results for a given request.
  - `next_page_url` string — URL of the next page results for a given request.

## Other responses

- `400` — Market not found.
- `401` — Requested resource requires authorization.
- `403` — Requested resource is not available with supplied credentials.
- `414` — Provided URI is too long. It must not be greater than 10000 symbols.

---

[API](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4.md) · [All operations](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinmetrics/coin-metrics-api-v4/revisions/774268c0a4fe/schema)