Skip to main content
GET
/
api
/
v1
/
watchlists
/
public
/
{userId}
/
{watchlistId}
Get single public watchlist
curl --request GET \
  --url https://public-api.etoro.com/api/v1/watchlists/public/{userId}/{watchlistId} \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "watchlistId": "12345",
  "name": "Tech Watchlist",
  "Gcid": 12345,
  "watchlistType": "Static",
  "totalItems": 100,
  "isDefault": true,
  "isUserSelectedDefault": true,
  "watchlistRank": 1,
  "dynamicUrl": "<string>",
  "items": [
    {
      "itemId": 12345,
      "itemType": "Instrument",
      "itemRank": 1
    }
  ],
  "relatedAssets": [
    12345,
    67890
  ]
}

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"edc7da7b-a643-457f-8658-8afbed1f8dd9"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

​
userId
integer<int32>
required

User ID who owns the watchlist

​
watchlistId
string
required

Unique identifier of the watchlist

Query Parameters

​
pageNumber
integer<int32>
default:0

Page number for pagination

​
itemsPerPage
integer<int32>
default:100

Number of items per page

Response

200 - application/json

Successfully retrieved public watchlist

Represents a watchlist with its metadata and items

​
watchlistId
string

Unique identifier of the watchlist

Example:

"12345"

​
name
string

Display name of the watchlist

Example:

"Tech Watchlist"

​
Gcid
integer<int32>

Global Customer ID of the watchlist owner

Example:

12345

​
watchlistType
enum<string>

Type of the watchlist

Available options:
Static,
Dynamic,
RecentlyInvested,
Default
Example:

"Static"

​
totalItems
integer<int32>

Total number of items in the watchlist

Example:

100

​
isDefault
boolean

Whether this is a default system watchlist

Example:

true

​
isUserSelectedDefault
boolean

Whether this is the user's selected default watchlist

Example:

true

​
watchlistRank
integer<int32>

Display order rank of the watchlist

Example:

1

​
dynamicUrl
string | null

URL for dynamic watchlist queries

​
items
object[]

Items contained in the watchlist

Example:
[
  {
    "itemId": 12345,
    "itemType": "Instrument",
    "itemRank": 1
  }
]
​
relatedAssets
integer<int32>[] | null

Related asset IDs

Example:
[12345, 67890]