Skip to main content
GET
/
api
/
v1
/
market-data
/
instruments
Retrieves metadata for specified instruments, including display names, exchange IDs, and classification.
curl --request GET \
  --url https://public-api.etoro.com/api/v1/market-data/instruments \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "instrumentDisplayDatas": [
    {
      "instrumentID": 123,
      "instrumentDisplayName": "<string>",
      "instrumentTypeID": 123,
      "exchangeID": 123,
      "symbolFull": "<string>",
      "stocksIndustryId": 123,
      "priceSource": "<string>",
      "hasExpirationDate": true,
      "isInternalInstrument": true,
      "images": [
        {
          "instrumentID": 123,
          "width": 123,
          "height": 123,
          "uri": "<string>",
          "backgroundColor": "<string>",
          "textColor": "<string>"
        }
      ]
    }
  ]
}

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"e2767c7c-0e70-4b88-b510-3b3e981f36d4"

​
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>[]

A comma seperated list of instrument ids to filter on

​
exchangeIds
integer<int32>[]

A comma seperated list of exchange ids to filter on

​
stocksIndustryIds
integer<int32>[]

A comma seperated list of stock industry ids to filter on

​
instrumentTypeIds
integer<int32>[]

A comma seperated list of instrument type ids to filter on

Response

200 - application/json

Success

​
instrumentDisplayDatas
object[]