Skip to main content
GET
Get single watchlist

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:

"7dc09cc6-9647-4920-9da0-eb405d7ea45d"

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

watchlistId
string
required

Unique identifier of the watchlist

Query Parameters

pageNumber
integer<int32>
default:0

Page number for pagination

Required range: x >= 0
itemsPerPage
integer<int32>
default:100

Number of items per page

Required range: 1 <= x <= 1000

Response

Successfully retrieved watchlist

Response containing multiple watchlists with metadata

status
integer<int32>

HTTP status code of the response

Example:

200

watchlists
object[]

List of user watchlists

exception
object

Exception details when the request partially failed

meta
object

Response metadata including pagination info

isSucceeded
boolean

Whether the request succeeded

Example:

true