Skip to main content
GET
/
api
/
v1
/
watchlists
/
default-watchlists
/
items
Get default watchlist items
curl --request GET \
  --url https://public-api.etoro.com/api/v1/watchlists/default-watchlists/items \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
[
  {
    "ItemId": 12345,
    "ItemType": "Instrument",
    "ItemRank": 1
  }
]

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"a6b110b9-af91-4630-83e9-ad631727d476"

​
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

200 - application/json

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