ETetoro
Watchlists

Get user's public watchlists

Rate limit: 60 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/watchlists
  • GET /api/v1/watchlists/default-watchlists/items
  • GET /api/v1/watchlists/public/{userId}/{watchlistId}
  • GET /api/v1/watchlists/{watchlistId}

Retrieves all public watchlists for a specific user.

get/api/v1/watchlists/public/{userId}

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

userIdinteger required

User ID whose public watchlists to retrieve

Query parameters

itemsPerPageForSingleinteger

Number of items per watchlist

Headers

x-request-idstring uuid required
Example:359c2723-fe7c-4975-becf-ea7a3d8beadd

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 public watchlists

statusinteger

HTTP status code of the response

isSucceededboolean

Whether the request succeeded

Example response

{
  "status": 200,
  "watchlists": [
    {
      "watchlistId": "12345",
      "name": "Tech Watchlist",
      "Gcid": 12345,
      "watchlistType": "Static",
      "totalItems": 100,
      "isDefault": true,
      "isUserSelectedDefault": true,
      "watchlistRank": 1,
      "items": [
        {
          "itemId": 12345,
          "itemType": "Instrument",
          "itemRank": 1
        }
      ],
      "relatedAssets": [
        12345,
        67890
      ]
    }
  ],
  "meta": {
    "itemsPerPage": 100,
    "maxItemsInWatchlistLimit": 1000,
    "maxWatchlistsLimit": 10
  },
  "isSucceeded": true
}

Changes

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