Remove items from watchlist

curl --request DELETE \
  --url https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>' \
  --data '
[
  {
    "itemId": 12345,
    "itemType": "Instrument",
    "itemRank": 1,
    "itemAddedReason": "Manual",
    "itemAddedDate": "2023-11-07T05:31:56Z",
    "market": {
      "id": "<string>",
      "symbolName": "<string>",
      "displayName": "<string>",
      "assetTypeId": 123,
      "assetTypeSubCategoryId": 123,
      "exchangeId": 123,
      "hasExpirationDate": true,
      "avatar": {
        "small": "<string>",
        "medium": "<string>",
        "large": "<string>",
        "svg": {
          "url": "<string>",
          "backgroundColor": "<string>",
          "textColor": "<string>"
        }
      }
    }
  }
]
'

import requests

url = "https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items"

payload = [
    {
        "itemId": 12345,
        "itemType": "Instrument",
        "itemRank": 1,
        "itemAddedReason": "Manual",
        "itemAddedDate": "2023-11-07T05:31:56Z",
        "market": {
            "id": "<string>",
            "symbolName": "<string>",
            "displayName": "<string>",
            "assetTypeId": 123,
            "assetTypeSubCategoryId": 123,
            "exchangeId": 123,
            "hasExpirationDate": True,
            "avatar": {
                "small": "<string>",
                "medium": "<string>",
                "large": "<string>",
                "svg": {
                    "url": "<string>",
                    "backgroundColor": "<string>",
                    "textColor": "<string>"
                }
            }
        }
    }
]
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<x-api-key>",
    "x-user-key": "<x-user-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<x-api-key>',
    'x-user-key': '<x-user-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify([
    {
      itemId: 12345,
      itemType: 'Instrument',
      itemRank: 1,
      itemAddedReason: 'Manual',
      itemAddedDate: '2023-11-07T05:31:56Z',
      market: {
        id: '<string>',
        symbolName: '<string>',
        displayName: '<string>',
        assetTypeId: 123,
        assetTypeSubCategoryId: 123,
        exchangeId: 123,
        hasExpirationDate: true,
        avatar: {
          small: '<string>',
          medium: '<string>',
          large: '<string>',
          svg: {url: '<string>', backgroundColor: '<string>', textColor: '<string>'}
        }
      }
    }
  ])
};

fetch('https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'itemId' => 12345,
        'itemType' => 'Instrument',
        'itemRank' => 1,
        'itemAddedReason' => 'Manual',
        'itemAddedDate' => '2023-11-07T05:31:56Z',
        'market' => [
                'id' => '<string>',
                'symbolName' => '<string>',
                'displayName' => '<string>',
                'assetTypeId' => 123,
                'assetTypeSubCategoryId' => 123,
                'exchangeId' => 123,
                'hasExpirationDate' => true,
                'avatar' => [
                                'small' => '<string>',
                                'medium' => '<string>',
                                'large' => '<string>',
                                'svg' => [
                                                                'url' => '<string>',
                                                                'backgroundColor' => '<string>',
                                                                'textColor' => '<string>'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-api-key: <x-api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <x-user-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items"

	payload := strings.NewReader("[\n  {\n    \"itemId\": 12345,\n    \"itemType\": \"Instrument\",\n    \"itemRank\": 1,\n    \"itemAddedReason\": \"Manual\",\n    \"itemAddedDate\": \"2023-11-07T05:31:56Z\",\n    \"market\": {\n      \"id\": \"<string>\",\n      \"symbolName\": \"<string>\",\n      \"displayName\": \"<string>\",\n      \"assetTypeId\": 123,\n      \"assetTypeSubCategoryId\": 123,\n      \"exchangeId\": 123,\n      \"hasExpirationDate\": true,\n      \"avatar\": {\n        \"small\": \"<string>\",\n        \"medium\": \"<string>\",\n        \"large\": \"<string>\",\n        \"svg\": {\n          \"url\": \"<string>\",\n          \"backgroundColor\": \"<string>\",\n          \"textColor\": \"<string>\"\n        }\n      }\n    }\n  }\n]")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("x-user-key", "<x-user-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<x-api-key>")
  .header("x-user-key", "<x-user-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"itemId\": 12345,\n    \"itemType\": \"Instrument\",\n    \"itemRank\": 1,\n    \"itemAddedReason\": \"Manual\",\n    \"itemAddedDate\": \"2023-11-07T05:31:56Z\",\n    \"market\": {\n      \"id\": \"<string>\",\n      \"symbolName\": \"<string>\",\n      \"displayName\": \"<string>\",\n      \"assetTypeId\": 123,\n      \"assetTypeSubCategoryId\": 123,\n      \"exchangeId\": 123,\n      \"hasExpirationDate\": true,\n      \"avatar\": {\n        \"small\": \"<string>\",\n        \"medium\": \"<string>\",\n        \"large\": \"<string>\",\n        \"svg\": {\n          \"url\": \"<string>\",\n          \"backgroundColor\": \"<string>\",\n          \"textColor\": \"<string>\"\n        }\n      }\n    }\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<x-api-key>'
request["x-user-key"] = '<x-user-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"itemId\": 12345,\n    \"itemType\": \"Instrument\",\n    \"itemRank\": 1,\n    \"itemAddedReason\": \"Manual\",\n    \"itemAddedDate\": \"2023-11-07T05:31:56Z\",\n    \"market\": {\n      \"id\": \"<string>\",\n      \"symbolName\": \"<string>\",\n      \"displayName\": \"<string>\",\n      \"assetTypeId\": 123,\n      \"assetTypeSubCategoryId\": 123,\n      \"exchangeId\": 123,\n      \"hasExpirationDate\": true,\n      \"avatar\": {\n        \"small\": \"<string>\",\n        \"medium\": \"<string>\",\n        \"large\": \"<string>\",\n        \"svg\": {\n          \"url\": \"<string>\",\n          \"backgroundColor\": \"<string>\",\n          \"textColor\": \"<string>\"\n        }\n      }\n    }\n  }\n]"

response = http.request(request)
puts response.read_body

Watchlists

Remove items from watchlist

Rate limit: 20 requests per 60 seconds. This is a shared quota — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota:

DELETE /api/v1/watchlists/{watchlistId}
POST /api/v1/watchlists
POST /api/v1/watchlists/default-watchlist/selected-items
POST /api/v1/watchlists/newasdefault-watchlist
POST /api/v1/watchlists/{watchlistId}/items
PUT /api/v1/watchlists/rank/{watchlistId}
PUT /api/v1/watchlists/setUserSelectedUserDefault/{watchlistId}
PUT /api/v1/watchlists/{watchlistId}
PUT /api/v1/watchlists/{watchlistId}/items

Removes specified items from a watchlist.

DELETE

api

watchlists

{watchlistId}

items

Remove items from watchlist

curl --request DELETE \
  --url https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>' \
  --data '
[
  {
    "itemId": 12345,
    "itemType": "Instrument",
    "itemRank": 1,
    "itemAddedReason": "Manual",
    "itemAddedDate": "2023-11-07T05:31:56Z",
    "market": {
      "id": "<string>",
      "symbolName": "<string>",
      "displayName": "<string>",
      "assetTypeId": 123,
      "assetTypeSubCategoryId": 123,
      "exchangeId": 123,
      "hasExpirationDate": true,
      "avatar": {
        "small": "<string>",
        "medium": "<string>",
        "large": "<string>",
        "svg": {
          "url": "<string>",
          "backgroundColor": "<string>",
          "textColor": "<string>"
        }
      }
    }
  }
]
'

import requests

url = "https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items"

payload = [
    {
        "itemId": 12345,
        "itemType": "Instrument",
        "itemRank": 1,
        "itemAddedReason": "Manual",
        "itemAddedDate": "2023-11-07T05:31:56Z",
        "market": {
            "id": "<string>",
            "symbolName": "<string>",
            "displayName": "<string>",
            "assetTypeId": 123,
            "assetTypeSubCategoryId": 123,
            "exchangeId": 123,
            "hasExpirationDate": True,
            "avatar": {
                "small": "<string>",
                "medium": "<string>",
                "large": "<string>",
                "svg": {
                    "url": "<string>",
                    "backgroundColor": "<string>",
                    "textColor": "<string>"
                }
            }
        }
    }
]
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<x-api-key>",
    "x-user-key": "<x-user-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<x-api-key>',
    'x-user-key': '<x-user-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify([
    {
      itemId: 12345,
      itemType: 'Instrument',
      itemRank: 1,
      itemAddedReason: 'Manual',
      itemAddedDate: '2023-11-07T05:31:56Z',
      market: {
        id: '<string>',
        symbolName: '<string>',
        displayName: '<string>',
        assetTypeId: 123,
        assetTypeSubCategoryId: 123,
        exchangeId: 123,
        hasExpirationDate: true,
        avatar: {
          small: '<string>',
          medium: '<string>',
          large: '<string>',
          svg: {url: '<string>', backgroundColor: '<string>', textColor: '<string>'}
        }
      }
    }
  ])
};

fetch('https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'itemId' => 12345,
        'itemType' => 'Instrument',
        'itemRank' => 1,
        'itemAddedReason' => 'Manual',
        'itemAddedDate' => '2023-11-07T05:31:56Z',
        'market' => [
                'id' => '<string>',
                'symbolName' => '<string>',
                'displayName' => '<string>',
                'assetTypeId' => 123,
                'assetTypeSubCategoryId' => 123,
                'exchangeId' => 123,
                'hasExpirationDate' => true,
                'avatar' => [
                                'small' => '<string>',
                                'medium' => '<string>',
                                'large' => '<string>',
                                'svg' => [
                                                                'url' => '<string>',
                                                                'backgroundColor' => '<string>',
                                                                'textColor' => '<string>'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-api-key: <x-api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <x-user-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items"

	payload := strings.NewReader("[\n  {\n    \"itemId\": 12345,\n    \"itemType\": \"Instrument\",\n    \"itemRank\": 1,\n    \"itemAddedReason\": \"Manual\",\n    \"itemAddedDate\": \"2023-11-07T05:31:56Z\",\n    \"market\": {\n      \"id\": \"<string>\",\n      \"symbolName\": \"<string>\",\n      \"displayName\": \"<string>\",\n      \"assetTypeId\": 123,\n      \"assetTypeSubCategoryId\": 123,\n      \"exchangeId\": 123,\n      \"hasExpirationDate\": true,\n      \"avatar\": {\n        \"small\": \"<string>\",\n        \"medium\": \"<string>\",\n        \"large\": \"<string>\",\n        \"svg\": {\n          \"url\": \"<string>\",\n          \"backgroundColor\": \"<string>\",\n          \"textColor\": \"<string>\"\n        }\n      }\n    }\n  }\n]")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("x-user-key", "<x-user-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<x-api-key>")
  .header("x-user-key", "<x-user-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"itemId\": 12345,\n    \"itemType\": \"Instrument\",\n    \"itemRank\": 1,\n    \"itemAddedReason\": \"Manual\",\n    \"itemAddedDate\": \"2023-11-07T05:31:56Z\",\n    \"market\": {\n      \"id\": \"<string>\",\n      \"symbolName\": \"<string>\",\n      \"displayName\": \"<string>\",\n      \"assetTypeId\": 123,\n      \"assetTypeSubCategoryId\": 123,\n      \"exchangeId\": 123,\n      \"hasExpirationDate\": true,\n      \"avatar\": {\n        \"small\": \"<string>\",\n        \"medium\": \"<string>\",\n        \"large\": \"<string>\",\n        \"svg\": {\n          \"url\": \"<string>\",\n          \"backgroundColor\": \"<string>\",\n          \"textColor\": \"<string>\"\n        }\n      }\n    }\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/watchlists/{watchlistId}/items")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<x-api-key>'
request["x-user-key"] = '<x-user-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"itemId\": 12345,\n    \"itemType\": \"Instrument\",\n    \"itemRank\": 1,\n    \"itemAddedReason\": \"Manual\",\n    \"itemAddedDate\": \"2023-11-07T05:31:56Z\",\n    \"market\": {\n      \"id\": \"<string>\",\n      \"symbolName\": \"<string>\",\n      \"displayName\": \"<string>\",\n      \"assetTypeId\": 123,\n      \"assetTypeSubCategoryId\": 123,\n      \"exchangeId\": 123,\n      \"hasExpirationDate\": true,\n      \"avatar\": {\n        \"small\": \"<string>\",\n        \"medium\": \"<string>\",\n        \"large\": \"<string>\",\n        \"svg\": {\n          \"url\": \"<string>\",\n          \"backgroundColor\": \"<string>\",\n          \"textColor\": \"<string>\"\n        }\n      }\n    }\n  }\n]"

response = http.request(request)
puts response.read_body

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:

"63c5ad3e-965d-4484-986b-ccc8c52c4959"

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

watchlistId

string

required

Unique identifier of the watchlist

Body

application/json

Items to remove from the watchlist

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

Show child attributes

Response

Items removed successfully

Add items to watchlist Get top assets for a user

⌘I

Getting started

Guides

Rest API

WebSocket API

Vibe Code

AI Agents

Remove items from watchlist

Authorizations

Headers

Path Parameters

Body

Response