API Reference

Sessions

Mint and drive warp sessions: copy-on-write books seeded from history, advanced at speed_x by client step calls. Six-hour wall-clock lifetime ceiling.

POST/tape/v1/sessions

REAL

Mints a new warp session over [from, to] at speed_x. Returns a session_id and the initial t_logical cursor.

Request body

Field	Type	Required	Description
from	string (ISO 8601)	yes	Start of historical window.
to	string (ISO 8601)	yes	End of historical window. Max 30 days (Phase A).
markets	array<string>	yes	Markets to include in the partitioned book.
speed_x	number	no	Default 1.0. Range 0.1–1000.

Response

Field	Type	Required	Description
session_id	string	no	UUID.
t_logical	integer	no	Initial cursor (= from in unix seconds).
speed_x	number	no	Resolved speed.
expires_at	string (ISO 8601)	no	Hard wall-clock ceiling (6h after mint).

Code

curl -s -X POST https://api.taifoon.dev/tape/v1/sessions \
  -H 'Content-Type: application/json' \
  -d '{"from":"2026-05-15T00:00:00Z","to":"2026-05-15T04:00:00Z","markets":["BTC-PERP"],"speed_x":100.0}' | jq

Errors

400BadRequestWindow > 30d, speed_x out of range, unknown market.
409ConflictAttribution already has an active session (Phase A limit).

GET/tape/v1/sessions

REAL

Lists all active warp sessions. Returns an empty list when nothing is running.

Code

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

POST/tape/v1/sessions/{id}/seek

REAL

Jump the session cursor to an absolute t_logical.

Request body

Field	Type	Required	Description
t_logical	integer	yes	Target unix seconds. Must be within the session window.

POST/tape/v1/sessions/{id}/step

REAL

Advance the cursor one tick (= 1 / speed_x wall-seconds of tape). Returns the new clock.

GET/tape/v1/sessions/{id}/receipt

REAL

The 3-actor receipt — decider, matcher, trader — plus the top-level causality_ok bit. Read at any time during the session and at finalize.

Code

curl -s https://api.taifoon.dev/tape/v1/sessions/<sid>/receipt | jq