Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

eToro Watchlists API

The Watchlists API from eToro — 12 operation(s) for watchlists.

eToro Watchlists API is one of 29 APIs that eToro publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Watchlists. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 17 operations across 12 paths, and defines 7 schemas. It is described by OpenAPI 3.0.1, at version v1.158.0.

Requests are made against the base URL https://public-api.etoro.com/api/v1.

17 operations 12 paths 7 schemas 2 DELETE7 GET4 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
v1.158.0
Base URL
https://public-api.etoro.com/api/v1
Resource Areas
1

Paths & Operations 17

Across 12 paths, the API surfaces 17 operations — 2 DELETE, 7 GET, 4 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Watchlists 17
GET
/api/v1/curated-lists
Get curated lists
getCuratedLists 3 params → 200204
GET
/api/v1/market-recommendations/{itemsCount}
Get market recommendations
getMarketRecommendations 4 params → 200204
GET
/api/v1/watchlists
Get user watchlists
getUserWatchlists 6 params → 200
POST
/api/v1/watchlists
Create a new watchlist
createANewWatchlist 6 params → 201
POST
/api/v1/watchlists/default-watchlist/selected-items
Create default watchlist with selected items
createDefaultWatchlistWithSelectedItems 3 params body → 201
GET
/api/v1/watchlists/default-watchlists/items
Get default watchlist items
getDefaultWatchlistItems 5 params → 200
POST
/api/v1/watchlists/newasdefault-watchlist
Create watchlist and set as default
createWatchlistAndSetAsDefault 6 params → 201
GET
/api/v1/watchlists/public/{userId}
Get user's public watchlists
getUserSPublicWatchlists 5 params → 200
GET
/api/v1/watchlists/public/{userId}/{watchlistId}
Get single public watchlist
getSinglePublicWatchlist 7 params → 200
PUT
/api/v1/watchlists/rank/{watchlistId}
Change watchlist rank
changeWatchlistRank 5 params → 204
PUT
/api/v1/watchlists/setUserSelectedUserDefault/{watchlistId}
Set a specific watchlist as user's default
setSpecificWatchlistUserSDefault 4 params → 200
GET
/api/v1/watchlists/{watchlistId}
Get single watchlist
getSingleWatchlist 6 params → 200
PUT
/api/v1/watchlists/{watchlistId}
Rename watchlist
renameWatchlist 5 params → 204
DELETE
/api/v1/watchlists/{watchlistId}
Delete watchlist
deleteWatchlist 4 params → 204
POST
/api/v1/watchlists/{watchlistId}/items
Add items to watchlist
addItemsToWatchlist 4 params body → 201
PUT
/api/v1/watchlists/{watchlistId}/items
Update items in watchlist
updateItemsInWatchlist 4 params body → 204
DELETE
/api/v1/watchlists/{watchlistId}/items
Remove items from watchlist
removeItemsFromWatchlist 4 params body → 204

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are WatchlistResponse (11 properties), WatchlistItemDto (6 properties), CuratedList (5 properties), WatchlistsResponse (5 properties). Each schema is shown below with its type and property counts.

WatchlistsResponse
object
Response containing multiple watchlists with metadata
5 properties
CuratedListItem
object
Represents an item in a curated list
1 property
CuratedList
object
Represents a curated investment list
5 properties
MarketRecommendationsResponse
object
Response containing market recommendations
2 properties
WatchlistItemDto
object
Represents an item in a watchlist
6 properties 2 required
WatchlistResponse
object
Represents a watchlist with its metadata and items
11 properties
CuratedListsResponse
object
Response containing curated investment lists
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

etoro-watchlists-api-openapi.yml Raw ↑

Other APIs eToro publishes across the network.

eToro Trading API
eToro Market Data API
eToro Portfolio and Account API
eToro Social and Discovery API
eToro Watchlists API
eToro Price Alerts API
eToro Agent Portfolios API
eToro Agent Portfolios API
eToro Asset Explorer API
eToro Attachments API
eToro Balances API
eToro Cash Accounts API