Skip to main content
GET
/
api
/
v1
/
market-data
/
instruments
/
{instrumentId}
/
history
/
candles
/
{direction}
/
{interval}
/
{candlesCount}
Get historical candles data for an instrument
curl --request GET \
  --url https://public-api.etoro.com/api/v1/market-data/instruments/{instrumentId}/history/candles/{direction}/{interval}/{candlesCount} \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "interval": "OneMinute",
  "candles": [
    {
      "instrumentId": 12,
      "candles": [
        {
          "instrumentID": 12,
          "fromDate": "2025-03-05T10:34:00Z",
          "open": 1.70227,
          "high": 1.70277,
          "low": 1.70221,
          "close": 1.70253,
          "volume": 0
        },
        {
          "instrumentID": 12,
          "fromDate": "2025-03-05T10:35:00Z",
          "open": 1.70252,
          "high": 1.70276,
          "low": 1.70244,
          "close": 1.70276,
          "volume": 0
        }
      ],
      "rangeOpen": 1.70227,
      "rangeClose": 1.70276,
      "rangeHigh": 1.70277,
      "rangeLow": 1.70221,
      "volume": 0
    }
  ]
}

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"b9d722ef-eb51-4c0e-9c6c-de8f6a1cf55c"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

​
direction
enum<string>
required

Sorting direction of the candles data. Use 'asc' for oldest to newest, or 'desc' for newest to oldest.

Available options:
asc,
desc
​
interval
enum<string>
required

Time interval for each candle. Determines the granularity of the price data. Shorter intervals provide more detailed price action but require more data points.

Available options:
OneMinute,
FiveMinutes,
TenMinutes,
FifteenMinutes,
ThirtyMinutes,
OneHour,
FourHours,
OneDay,
OneWeek
​
candlesCount
integer
default:100
required

Number of candles to retrieve. Maximum value is 1000. For longer historical periods, consider using a larger time interval or making multiple requests.

Required range: x <= 1000
​
instrumentId
integer
required

Unique identifier of the financial instrument to retrieve candles for. This ID is consistent across all eToro systems.

Response

200 - application/json

Successful retrieval of candles data

Response containing historical price data in candlestick format

​
interval
enum<string>

Time interval of the returned candles. Matches the interval parameter from the request.

Available options:
OneMinute,
FiveMinutes,
TenMinutes,
FifteenMinutes,
ThirtyMinutes,
OneHour,
FourHours,
OneDay,
OneWeek
​
candles
object[]

List of candle data grouped by instrument