API Reference

Tape

The tape surface backs replay sessions and historical reads. Candles, the matcher clock, and the mark price all live here. In a warp session, every endpoint accepts a session= query param and answers in session time.

GET/tape/v1/candles

REAL

OHLCV candles for a market and timeframe. Backed by the matcher cross stream. In a warp session it streams the session's replayed crosses.

Query parameters

Field	Type	Required	Description
market	string	yes	e.g. "BTC-PERP".
tf	string	yes	"1m" \| "3m" \| "10m" \| "30m" \| "90m" \| "session" \| "day" \| "week".
limit	integer	no	Default 200, max 1000.
to	integer	no	Upper-bound t_logical. Default = now.
session	string	no	Warp session id.

Response

Field	Type	Required	Description
candles	array	no	Ascending by t.
candles[].t	integer	no	Bucket-open unix seconds.
candles[].o	number	no	Open price.
candles[].h	number	no	High.
candles[].l	number	no	Low.
candles[].c	number	no	Close.
candles[].v	number	no	Volume in base units.
mode	string	no	"wall" or "warp".
speed_x	number	no	1.0 in live; the session speed in warp.
t_logical	integer	no	Current cursor.

Code

curl -s 'https://api.taifoon.dev/tape/v1/candles?market=BTC-PERP&tf=1m&limit=3' | jq

GET/tape/v1/clock

REAL

The matcher clock — current logical time, current mode, current session (if any).

Query parameters

Field	Type	Required	Description
session	string	no	If present, returns the session clock.

Response

Field	Type	Required	Description
now	integer	no	Current t_logical (unix seconds).
speed_x	number	no	1.0 in wall mode.
mode	string	no	"wall" \| "warp".
session	string\|null	no	Session id when in warp mode.

Code

curl -s https://api.taifoon.dev/tape/v1/clock | jq

GET/tape/v1/mark

PLANNED · 404

Oracle-backed mark price. Phase B will pull Binance/Kraken/Drift index. Today the UI synthesises this from the book midpoint.

GET/tape/v1/fills

PLANNED · 404

The cross-market fill firehose. Returns 404 today. Use /book/v1/fills?market=... per-market for now.