Sign in

v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Market Data

Get instrument candle history

Rate limit: 120 requests per 60 seconds. This is a shared quota — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota:

  • GET /api/v1/market-data/exchanges
  • GET /api/v1/market-data/instrument-types
  • GET /api/v1/market-data/instruments
  • GET /api/v1/market-data/instruments/history/closing-price
  • GET /api/v1/market-data/instruments/rates
  • GET /api/v1/market-data/search
  • GET /api/v1/market-data/stocks-industries

Retrieves historical price data in OHLCV (Open, High, Low, Close, Volume) format for a specified instrument. The data is organized into time-based candles of various intervals, from one minute to one week.

get/api/v1/market-data/instruments/{instrumentId}/history/candles/{direction}/{interval}/{candlesCount}

Path parameters

direction'asc' | 'desc' required

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

interval'OneMinute' | 'FiveMinutes' | 'TenMinutes' | 'FifteenMinutes' | 'ThirtyMinutes' | 'OneHour' | 'FourHours' | 'OneDay' | 'OneWeek' 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.

candlesCountinteger required

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

instrumentIdinteger required

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

Headers

x-request-idstring uuid required
Example:ff6c86dc-80af-4130-84d4-b296512814bf

A unique request identifier.

x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Response

Successful retrieval of candles data

interval'OneMinute' | 'FiveMinutes' | 'TenMinutes' | 'FifteenMinutes' | 'ThirtyMinutes' | 'OneHour' | 'FourHours' | 'OneDay' | 'OneWeek'

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