Skip to main content
POST
Create a new 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:

"b7af91e4-b9f8-41dc-8ce4-eea763141f82"

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
Example:

"Tech Watchlist"

type
enum<string>
default:Static

Type of watchlist to create

Available options:
Static,
Dynamic
Example:

"Static"

dynamicQuery
string

Dynamic query URL for dynamic watchlists

Response

Watchlist created 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