ETetoro
Watchlists

Get market recommendations

Rate limit: 60 requests per 60 seconds. This is a dedicated limit for this endpoint — it is not shared with (pooled across) any other endpoint, so the full rate is available to this endpoint alone.

Retrieves personalized market recommendations for the authenticated user.

get/api/v1/market-recommendations/{itemsCount}

Request

  • Base URL
    https://public-api.etoro.com
  • Auth
    • OAuth 2
      Authorization code
      Scopesetoro-public:demo:read
    • or OAuth 2
      Authorization code
      Scopesetoro-public:real:read
    • or OAuth 2
      Authorization code
      Scopesetoro-public:demo:write
    • or OAuth 2
      Authorization code
      Scopesetoro-public:real:write
    • or OAuth 2
      Authorization code
      Scopesetoro-public:watchlist:read
    • or OAuth 2
      Authorization code
      Scopesetoro-public:watchlist:write
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

itemsCountinteger required

Number of recommendations to return

Headers

x-request-idstring uuid required
Example:6dbbf2d0-bc12-4d32-a782-badb433d6aea

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

Successfully retrieved market recommendations

ResponseTypestring

Type of recommendation response

Recommendationsinteger[]

List of recommended instrument IDs

Example response

{
  "ResponseType": "Instrument",
  "Recommendations": [
    12345,
    67890
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.