---
title: "Remove items from watchlist"
method: DELETE
path: "/api/v1/watchlists/{watchlistId}/items"
tags: ["Watchlists"]
---

# Remove items from watchlist

`DELETE /api/v1/watchlists/{watchlistId}/items`

**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.

## Path parameters

- `watchlistId` string, required

## Headers

- `x-request-id` string, uuid, required
- `x-api-key` string, password, required
- `x-user-key` string, password, required

## Request body

- WatchlistItemDto[]
  - `itemId` integer, required — Unique identifier of the financial instrument
  - `itemType` string, required — Type of the financial instrument (e.g., 'Instrument', 'Person')
  - `itemRank` integer — Ranking position of the item in the watchlist
  - `itemAddedReason` string — Reason the item was added to the watchlist
  - `itemAddedDate` string, date-time — Date and time the item was added
  - `market` object — Market metadata for the instrument when included
    - `id` string
    - `symbolName` string
    - `displayName` string
    - `assetTypeId` integer
    - `assetTypeSubCategoryId` integer, nullable
    - `exchangeId` integer
    - `hasExpirationDate` boolean
    - `avatar` object
      - `small` string
      - `medium` string
      - `large` string
      - `svg` object, nullable — SVG avatar with background and text colors
        - `url` string
        - `backgroundColor` string
        - `textColor` string

## Response `204`

Items removed successfully

## Other responses

- `429` — Too Many Requests — the shared rate limit (20 requests / 60s) was exceeded.

---

[API](https://skmtc.dev/etoro/apis/etoro-api.md) · [All operations](https://skmtc.dev/etoro/apis/etoro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/etoro/etoro-api/revisions/69c1fb266c35/schema)