Skip to main content
GET
Get default watchlist items

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:

"df880422-60d7-4a94-befd-80982bf9267b"

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

itemsLimit
integer<int32>

Maximum number of items to return

itemsPerPage
integer<int32>
default:100

Number of items per page for pagination

Response

Successfully retrieved default watchlist items

itemId
integer<int32>
required

Unique identifier of the financial instrument

Example:

12345

itemType
string
required

Type of the financial instrument (e.g., 'Instrument', 'Person')

Example:

"Instrument"

itemRank
integer<int32>
default:0

Ranking position of the item in the watchlist

Example:

1

itemAddedReason
string

Reason the item was added to the watchlist

Example:

"Manual"

itemAddedDate
string<date-time>

Date and time the item was added

market
object

Market metadata for the instrument when included