Skip to main content
POST
Create watchlist and set as default

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:

"5ff50fd9-4b8b-4a30-91fd-246d26ae782c"

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

name
string
required

Name of the new watchlist

Maximum string length: 100
type
enum<string>
default:Static

Type of watchlist to create

Available options:
Static,
Dynamic
dynamicQuery
string

Query string for dynamic watchlists

Response

Watchlist created and set as default successfully

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