Skip to main content
DELETE
/
v1
/
watchlist
/
{watchlist_id}
Delete Watchlist by ID
curl --request DELETE \
  --url https://api.aries.com/v1/watchlist/{watchlist_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 12345,
  "name": "Default",
  "symbols": []
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

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

Watchlist deleted or reset successfully; returns the watchlist object

Saved list of symbols a user wants to monitor. Watchlists are read-only from a trading-risk perspective and do not place orders.

​
id
integer<int64>

Watchlist identifier. Use this value when reading, updating, or deleting a specific watchlist.

​
name
string

User-facing watchlist name, such as Tech Stocks or Dividend Ideas. Show this as the list label in your app.

​
symbols
string[]

Symbols saved in the watchlist. Use exact uppercase ticker symbols and confirm unfamiliar symbols with symbol search.