DOCS

REST API

A small REST surface for latest quotes, historical backfill and reference data.

The REST API complements the stream: use it for the latest quote, to backfill history before going live, and to list reference data. Base URL: https://api.tick-stream.xyz/v1. All requests need an API key; timestamps are ISO-8601 (UTC).

GET /quote

The latest trade and top-of-book for a symbol.

Param	Required	Description
`symbol`	yes	The instrument, e.g. `ES`.

curl "https://api.tick-stream.xyz/v1/quote?symbol=ES" \
  -H "Authorization: Bearer sk_live_…"

{
  "symbol": "ES",
  "price": 5283.25,
  "bid": 5283.00,
  "ask": 5283.25,
  "ts": 1749556800
}

GET /ticks

Historical ticks for a time window — the backfill endpoint. Results are paginated and ordered by time.

Param	Required	Description
`symbol`	yes	The instrument.
`start` / `end`	yes	ISO-8601 UTC bounds of the window.
`cursor`	no	Pagination cursor returned as `next` in the response.
`limit`	no	Max rows per page (default 10,000).

curl "https://api.tick-stream.xyz/v1/ticks?symbol=ES&start=2025-06-01T13:30:00Z&end=2025-06-01T20:00:00Z" \
  -H "Authorization: Bearer sk_live_…"

from tickstream import Client
ticks = Client("sk_live_…").ticks(
    "ES", start="2025-06-01T13:30:00Z", end="2025-06-01T20:00:00Z")
print(len(ticks), "ticks")

History depth depends on your plan — the free Delayed tier includes full backfill for research.

status

Historical backfill is rolling out — /quote, /symbols and /options are live today.

GET /symbols & GET /options

Reference data lives at /symbols (all instruments) and /options (chains, Pro plan). See those pages for the full parameters and response shapes.

tip

For continuous live data prefer the WebSocket stream — REST is best for snapshots and backfill, not high-frequency polling. See rate limits.