Skip to main content
GET
/
api
/
v1
/
market-data
/
instruments
/
rates
Retrieve current market rates and pricing information for specified instruments
curl --request GET \
  --url https://public-api.etoro.com/api/v1/market-data/instruments/rates \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "rates": [
    {
      "instrumentID": 123,
      "ask": 123,
      "bid": 123,
      "lastExecution": 123,
      "conversionRateAsk": 123,
      "conversionRateBid": 123,
      "date": "2023-11-07T05:31:56Z",
      "unitMargin": 123,
      "unitMarginAsk": 123,
      "unitMarginBid": 123,
      "priceRateID": 123,
      "bidDiscounted": 123,
      "askDiscounted": 123,
      "unitMarginBidDiscounted": 123,
      "unitMarginAskDiscounted": 123
    }
  ]
}

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"1efb9a07-1d84-4155-a08f-375b12a4a7d9"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Query Parameters

​
instrumentIds
integer<int32>[]
required

Comma-separated list of instrument IDs to retrieve market rates for. Each ID represents a unique tradable asset in the system.

Maximum array length: 100

Response

Successfully retrieved current market rates

Container for real-time market rates data

​
rates
object[]

Array of current market rates for requested instruments