Changelog

Versioned change history for PAX Trader Track API. Follow @predictasiax for release announcements.

Versioning policy

PAX follows Semantic Versioning for the public API surface:

Change type	Version bump	Advance notice
Breaking — endpoint removed, field renamed/removed, type changed, auth changed	MAJOR (v1 → v2)	90 days min; deprecated endpoint returns `Deprecation` header
Additive — new endpoint, new optional field, new enum value	MINOR (v1.0 → v1.1)	None (safe to deploy anytime)
Fix — bug fix, spec doc update, non-behavior-changing	PATCH (v1.0.0 → v1.0.1)	None

Ring 1 handlers live on production

POST /api/v1/markets — template-driven market creation with deterministic ID (m_<sha256[0:16]>), idempotent under same (template, params, creator) tuple
GET /api/v1/markets/templates — list active market templates, filter by category / market_type
5 seed templates: crypto_price_binary_60s, crypto_price_binary_5m, crypto_price_target_by_date, sports_match_winner_binary, election_binary
Envelope response with {ok, data, meta}; meta includes request_id, server_ts_ms, duration_ms, server_region
Full JSON Schema param validation (required / type / enum / minimum / maximum) with actionable error details (details.field, details.allowed, details.got)
Error ordering: validation errors surface before READ_ONLY_MODE gate — partners see param errors first (Stripe pattern), gate only fires for well-formed but blocked requests
Audit trail on market creation (fire-and-forget, idempotency-keyed)
WS broadcast of markets_updated on new creator market

Prod is currently in read_only_mode = 1 — POST /v1/markets validates + returns 503 READ_ONLY_MODE for well-formed requests. This is intentional (safety gate). Contact partners@predictasiax.com to enable creator markets on your account.
Sandbox environment (with faucet, mock oracle, no gate) shipping ~Aug 15.

Initial public release

Discovery: GET /v1/markets, GET /v1/markets/{id}, GET /v1/markets/templates, GET /v1/health
Market Data: GET /v1/candles/{market_id}, GET /v1/orderbook/{market_id}, GET /v1/trades/{market_id}
Account: GET /v1/account, /v1/account/positions, /v1/account/orders, /v1/account/trades
Trading: POST /v1/orders, DELETE /v1/orders/{id}, POST /v1/markets (creator markets, template-driven, deterministic ID)
Keys: POST /v1/keys, GET /v1/keys, DELETE /v1/keys/{id}
Sandbox: POST /v1/sandbox/faucet, POST /v1/sandbox/reset, POST /v1/sandbox/mock-oracle
WebSocket: Single-connection multiplex at wss://predictasiax.com/ws with 4 client methods (SUBSCRIBE / UNSUBSCRIBE / AUTH / LOCALE) and 48 server event types
Auth: 3 schemes — API Key (sk_live_* / sk_test_*), HMAC (Polymarket-compatible 5 headers), Session Bearer
Sandbox environment: sandbox.predictasiax.com with pre-seeded evergreen markets, faucet, reset, mock oracle
Response canonicalization: {ok, data, meta} envelope, snake_case keys, money as decimal string, *_at_ms sibling for timestamps
Web3 privacy: PII (email/phone/IP) stripped from external responses by default; self-view paths preserve
Docs: OpenAPI 3.1 spec, AsyncAPI 2.6 spec, Redoc + AsyncAPI React viewer at docs.predictasiax.com

Engine-agnostic top-level fields (never leak AMM vs CLOB — meta.fill_venue optional debug)
Deterministic market IDs (m_<sha256[0:16]>) for idempotent create
Chain-agnostic future-proofing (chain_data JSONB nullable on core tables)
3 canonical response modes: /v1/*, ?_v=2, Accept-Version: 2

Subscribe to release notes. Follow @predictasiax or email partners@predictasiax.com for early access.

Python + TypeScript SDKs — pip / npm installable
Search endpoints — GET /v1/search across markets/creators
Notifications — GET /v1/notifications, WS notification channel
Portfolio analytics — GET /v1/account/pnl, /v1/account/equity-history
Additional market templates — 15m/30m/1h binary, multi-outcome, scalar (over/under)

Operator Track (RGS + Seamless Wallet) — iGaming operator integration (Bragg/Kambi/Stake Engine compatible)
Partner rev-share ledger — automated attribution + payout
Builder Program — volume-based rewards for apps built on PAX

FIX 4.4 gateway — institutional order entry (Kalshi-style)
On-chain settlement mode — Base L2 chain-data columns activated (currently null-reserved)
Breaking: standardize all currency to decimal string (some legacy fields still emit float)

When an endpoint or field is deprecated:

Machine-readable changelog RSS: docs.predictasiax.com/changelog.rss (coming Q4 2026)