tickmast / docs
api v4.2

Quote aggregation API

Snapshots, end-of-day history and a streaming feed over a single token-authenticated endpoint. All timestamps are UTC in RFC 3339, all prices are decimal strings — never floats.

Base URL

# all requests
https://tickmast.com/v4

Authentication

Pass the key as a bearer token. Keys are scoped per environment; a key issued for staging is rejected in production with 403 scope_mismatch.

curl https://tickmast.com/v4/quote/AAPL.XNAS \
  -H "Authorization: Bearer tk_live_…"

Snapshots

GET/v4/quote/{symbol}

Last known quote for a single instrument. Symbols are TICKER.MIC — the ticker plus the ISO 10383 market code.

{
  "symbol": "AAPL.XNAS",
  "bid": "229.41",
  "ask": "229.44",
  "last": "229.42",
  "volume": 41882190,
  "ts": "2026-08-20T15:42:07.113Z"
}

History

GET/v4/history/{symbol}?from=&to=&interval=

End-of-day bars back to 2009. interval accepts 1d, 1w, 1mo. Ranges longer than 5 years are paginated with an opaque cursor.

Streaming

WSS/v4/stream

Subscribe after the socket opens. The server sends a heartbeat every 15 seconds; treat two missed heartbeats as a dead connection and reconnect with backoff.

{ "op": "subscribe", "channels": ["quotes"], "symbols": ["AAPL.XNAS", "VOLV-B.XSTO"] }

Rate limits

PlanRequestsStreaming symbols
evaluation60 / minute25
standard1 200 / minute2 000
dedicatednegotiatedunlimited

Every response carries X-RateLimit-Remaining and X-RateLimit-Reset. Exceeding the limit returns 429 with a Retry-After header — respect it rather than retrying immediately.

Errors

CodeMeaning
400 bad_symbolSymbol is malformed or the market code is unknown.
401 no_tokenAuthorization header missing or unparseable.
403 scope_mismatchKey is valid but not for this environment or dataset.
404 not_coveredInstrument exists but is not part of your coverage.
429 rate_limitedToo many requests. See Retry-After.
503 feed_staleUpstream feed is behind. Retry; do not treat as a price of zero.

Coverage

68 412 instruments across 41 venues. Nordic and Baltic venues are primary, US and major European venues are consolidated. A full symbol list is available as a daily CSV at /v4/reference/instruments.csv.