---
title: "Remove Symbol From Watchlist"
method: DELETE
path: "/api/watchlists/{watchlist_id}/symbols/{symbol}"
tags: ["watchlists"]
---

# Remove Symbol From Watchlist

`DELETE /api/watchlists/{watchlist_id}/symbols/{symbol}`

## Request

- Base URL: `https://api.halalterminal.com`
- URL: `https://api.halalterminal.com/api/watchlists/{watchlist_id}/symbols/{symbol}`
- Auth: API key in header `X-API-Key`

Remove a symbol from a watchlist.

Removes the specified ticker symbol from the watchlist. Returns the
updated watchlist. Raises 404 if the watchlist does not exist.

**curl example**:
```bash
curl -X DELETE https://api.halalterminal.com/api/watchlists/wl_abc123/symbols/AMZN \
  -H "X-API-Key: sk_live_abc123def456"
```

**Python example**:
```python
import requests

resp = requests.delete(
    "https://api.halalterminal.com/api/watchlists/wl_abc123/symbols/AMZN",
    headers={"X-API-Key": "sk_live_abc123def456"},
)
updated = resp.json()
```

## Path parameters

- `watchlist_id` string, required: Watchlist ID.
- `symbol` string, required: Ticker symbol to remove from the watchlist.

## Response `200`

The updated watchlist with the symbol removed

- WatchlistResponse: Representation of a watchlist with its symbols and metadata.
  - `id` string, required: Unique watchlist identifier
  - `name` string, required: Display name of the watchlist
  - `symbols` string[], required: Ticker symbols in the watchlist
  - `count` integer, required: Number of symbols currently in the watchlist
  - `created_at` string, required: ISO-8601 timestamp when the watchlist was created
  - `updated_at` string, required: ISO-8601 timestamp of the last modification

## Other responses

- `401`: Missing or invalid API key
- `404`: Watchlist not found
- `422`: Validation Error
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)