Delete Watchlist by ID

Permanently removes a specific watchlist identified by its unique ID. This targeted deletion removes the watchlist and its symbol collection without affecting other watchlists or account data.

Use Case: Remove individual watchlists that are no longer needed while maintaining other symbol tracking lists in the account.

DELETE /v1/watchlist/{watchlist_id}

Delete Watchlist by ID

cURL

curl --request DELETE \
  --url https://api.aries.com/v1/watchlist/{watchlist_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": 12345,
  "name": "Default",
  "symbols": []
}

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

watchlist_id · integer<int64> · required

The unique identifier of the watchlist to delete (integer)

Example:

12345

Response

200

application/json

Watchlist deleted or reset successfully; returns the watchlist object

id · integer<int64>

Watchlist ID

name · string

Watchlist name

symbols · string[]

Array of stock symbols