---
title: "GET /candles/perpetualMarkets/{ticker}"
method: GET
path: "/candles/perpetualMarkets/{ticker}"
---

# GET /candles/perpetualMarkets/{ticker}

`GET /candles/perpetualMarkets/{ticker}`

## Path parameters

- `ticker` string, required

## Query parameters

- `resolution` '1MIN' | '5MINS' | '15MINS' | '30MINS' | '1HOUR' | '4HOURS' | '1DAY', required
- `limit` number, double
- `fromISO` string
- `toISO` string

## Response `200`

Ok

- CandleResponse
  - `candles` CandleResponseObject[], required
    - `startedAt` string, required
    - `ticker` string, required
    - `resolution` '1MIN' | '5MINS' | '15MINS' | '30MINS' | '1HOUR' | '4HOURS' | '1DAY', required
    - `low` string, required
    - `high` string, required
    - `open` string, required
    - `close` string, required
    - `baseTokenVolume` string, required
    - `usdVolume` string, required
    - `trades` number, double, required
    - `startingOpenInterest` string, required
    - `orderbookMidPriceOpen` string, nullable
    - `orderbookMidPriceClose` string, nullable
    - `id` string, required

## Changes

- **2024-08-07** `c64679b5c579` — 2 info
  - added the optional property `candles/items/orderbookMidPriceClose` to the response with the `200` status
  - added the optional property `candles/items/orderbookMidPriceOpen` to the response with the `200` status
- **2024-08-06** `b77e3d143cc3` — 2 warning
  - removed the optional property `candles/items/orderbookMidPriceClose` from the response with the `200` status
  - removed the optional property `candles/items/orderbookMidPriceOpen` from the response with the `200` status
- **2024-07-25** `c64679b5c579` — 2 info
  - added the optional property `candles/items/orderbookMidPriceClose` to the response with the `200` status
  - added the optional property `candles/items/orderbookMidPriceOpen` to the response with the `200` status
- **2024-05-14** `90fd32395633` — 2 warning
  - removed the optional property `candles/items/orderbookMidPriceClose` from the response with the `200` status
  - removed the optional property `candles/items/orderbookMidPriceOpen` from the response with the `200` status

[Change history](https://skmtc.dev/dydxprotocol/apis/indexer-api/changes/candles/perpetualMarkets/:ticker/get.md)

---

[API](https://skmtc.dev/dydxprotocol/apis/indexer-api.md) · [All operations](https://skmtc.dev/dydxprotocol/apis/indexer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dydxprotocol/indexer-api/revisions/5005547cef75/schema)