List Watchlists

List all watchlists.

Returns every watchlist owned by the authenticated user, ordered by creation date.

curl example:

curl https://api.halalterminal.com/api/watchlists \
  -H "X-API-Key: sk_live_abc123def456"

Python example:

import requests

resp = requests.get(
    "https://api.halalterminal.com/api/watchlists",
    headers={"X-API-Key": "sk_live_abc123def456"},
)
watchlists = resp.json()

get/api/watchlists

Request

Base URL: https://api.halalterminal.com
URL: https://api.halalterminal.com/api/watchlists
Auth: API key in header X-API-Key

Response

All watchlists for the authenticated user

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.