Delete Watchlist

Deletes a watchlist owned by the authenticated user, identified by its numeric watchlist_id. If the targeted watchlist is the user’s only remaining watchlist, the API does not remove it; instead it resets the watchlist to a default empty state (name set to Default, symbols cleared) so the user always has at least one watchlist. The affected watchlist is returned in the response so clients can refresh local state without an extra read.

Use Case: Remove an individual watchlist that is no longer needed while keeping the rest of the user’s watchlists intact.

DELETE /v1/config/watchlist/{watchlist_id}

Delete Watchlist

cURL

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

200

deleted

{
  "id": 12345,
  "name": "Tech Stocks",
  "symbols": [
    "AAPL",
    "GOOGL",
    "MSFT"
  ]
}

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 numeric ID of the watchlist to delete. You can get this from a previous list/create/update response (the id field in the returned watchlist).

Example:

12345

Response

200

application/json

Watchlist deleted, or reset to default when it was the user's only remaining watchlist. The response body contains the affected watchlist.

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.