Skip to main content
GET
/
api
/
v1
/
market-recommendations
/
{itemsCount}
Get market recommendations
curl --request GET \
  --url https://public-api.etoro.com/api/v1/market-recommendations/{itemsCount} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "ResponseType": "Instrument",
  "Recommendations": [
    12345,
    67890
  ]
}

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:

"0168d45e-9142-4571-9d8d-9074f34b4311"

​
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

​
itemsCount
integer<int16>
default:10
required

Number of recommendations to return

Required range: 1 <= x <= 100

Response

Successfully retrieved market recommendations

Response containing market recommendations

​
ResponseType
string

Type of recommendation response

Example:

"Instrument"

​
Recommendations
integer<int32>[]

List of recommended instrument IDs

Example:
[12345, 67890]