Skip to main content
GET
Get user watchlists

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:

"bf7f9bdd-6ec8-4ed6-903b-a34995ff4a1c"

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

itemsPerPageForSingle
integer<int32>
default:100

Number of items to include per watchlist for pagination

Required range: 1 <= x <= 1000
Example:

100

ensureBuiltinWatchlists
boolean
default:true

Whether to ensure built-in watchlists are included

Example:

true

Whether to include related assets in the response

Example:

false

Response

Successfully retrieved user watchlists

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