Skip to main content
GET
Get instrument candle history

Authorizations

x-api-key
string
header
default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key
string
header
default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"08c892d9-25bb-4039-9e64-a254a9b6dc3d"

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

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