---
title: "Forex Candles"
method: GET
path: "/forex/candle"
tags: ["Default"]
---

# Forex Candles

`GET /forex/candle`

Get candlestick data for forex symbols.

## Query parameters

- `symbol` string, required
- `resolution` string, required
- `from` integer, required
- `to` integer, required

## Response `200`

successful operation

- ForexCandles
  - `o` number[] — List of open prices for returned candles.
  - `h` number[] — List of high prices for returned candles.
  - `l` number[] — List of low prices for returned candles.
  - `c` number[] — List of close prices for returned candles.
  - `v` number[] — List of volume data for returned candles.
  - `t` number[] — List of timestamp for returned candles.
  - `s` string — Status of the response. This field can either be ok or no_data.

## Changes

- **2021-07-23** `a148c0b2d583` — 1 info
  - api tag `Default` added
- **2020-06-24** `0bf39a0b1e67` — 1 info
  - endpoint added
- **2020-06-23** `9dd521fb3157` — 1 breaking
  - api path removed without deprecation
- **2020-06-12** `fea47f48a0f6` — 1 warning
  - deleted the `query` request parameter `format`
- **2020-06-09** `9710addc4f34` — 2 breaking
  - the `query` request parameter `from` became required
  - the `query` request parameter `to` became required

[Full history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/forex/candle/get.md)

---

[API](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api.md) · [All operations](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finnhub-stock-api/finnhub-api/revisions/415b27331384/schema)