API reference

Universe

GET/universeNo key needed

Symbols the nightly covers

Returns every symbol the active nightly manifest covers, sorted. Use it to check a symbol before tracking it; the unknown_symbol error from PUT /tickers points here. The list is empty when no manifest is active. No key is needed; the answer is cached for an hour and keyless calls are limited per IP.

Authentication

No key needed. Without one the call is limited to 30 requests a minute per IP; with a key it counts against the key's limits instead.

Request

curl "https://api.tradingpal.io/api/v1/universe"

Response

JSON. The fields this route adds are below; every response also carries the envelope fields (api_version, as_of_session, data_version, source, disclaimer).

FieldTypeDescription
countintegerNumber of symbols.
symbolsarray of stringEvery symbol the active nightly manifest covers, sorted. Empty when no manifest is active.

Example response

Response
{
  "api_version": "v1",
  "count": 2,
  "symbols": [
    "AAPL",
    "NVDA"
  ]
}

Errors

Errors are JSON with the Error shape; the fix field says what to do.

StatusCodeMeaningFix
429rate_limitedThe key passed 60 requests in a minute or 10,000 in a day, or a keyless caller passed 30 a minute from one IP.Wait details.retry_after_seconds, then retry. Cache the nightly answers; they do not change until the next session.