Skip to main content
GET
Get instrument candle history

Authorizations

Authorization
string
header
required

eToro OAuth2. Each operation lists the scopes that grant access as separate security requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. The same scopes back the x-api-key/x-user-key credential pair.

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"db2d361a-5b9f-4153-94ed-3a4e27b6d32a"

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

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