watchlists

Add Symbol To Watchlist

Add a symbol to an existing watchlist.

Appends a single ticker symbol to the watchlist. Returns the updated watchlist. Raises 404 if the watchlist does not exist.

curl example:

curl -X POST https://api.halalterminal.com/api/watchlists/wl_abc123/symbols \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_abc123def456" \
  -d '{"symbol": "AMZN"}'

Python example:

import requests

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

Request

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

Path parameters

watchlist_idstring required

Watchlist ID.

Request body

symbolstring required

Stock ticker symbol to add (e.g. AAPL)

Example request

{
  "symbol": "AMZN"
}

Response

The updated watchlist with the new symbol added

idstring required

Unique watchlist identifier

namestring required

Display name of the watchlist

symbolsstring[] required

Ticker symbols in the watchlist

countinteger required

Number of symbols currently in the watchlist

created_atstring required

ISO-8601 timestamp when the watchlist was created

updated_atstring required

ISO-8601 timestamp of the last modification

Example response

{
  "count": 3,
  "created_at": "2025-06-01T12:00:00Z",
  "id": "wl_abc123",
  "name": "Halal Tech",
  "symbols": [
    "AAPL",
    "MSFT",
    "GOOGL"
  ],
  "updated_at": "2025-06-01T12:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.