PredictAsiaX API Docs

📖 REST API

18 endpoints across Discovery, Market Data, Account, Trading, Sandbox, Keys. Envelope response + Money as decimal string.

Open Redoc →

⚡ WebSocket API

Single connection with subscription filtering. 48 event types across market data, fast round, account, security, ops. High-throughput multiplexed stream.

Open AsyncAPI →

🧪 Sandbox

Dedicated environment at sandbox.predictasiax.com with faucet, reset, mock oracle. sk_test_*

Read blueprint →

🚀 Getting Started

Mint key → faucet 10k USDT → place order → subscribe to fills. 5-minute curl walkthrough.

Start now →

🔐 Authentication

3 schemes: API Key, HMAC (Polymarket-compatible 5-header), Session Bearer. Signing code in Python / Node / Bash.

Read auth guide →

📦 Downloads

OpenAPI + AsyncAPI in YAML/JSON. Postman collection + sandbox/prod environments. Codegen ready.

Get files →

Get started in 30 seconds

1

Mint an API key

Sign in on predictasiax.com → Settings → API Keys. Get sk_live_* for prod or sk_test_* for sandbox.

2

List markets (public)

curl https://predictasiax.com/api/v1/markets \
  -H "X-Api-Key: sk_live_..."

3

Subscribe to fast ticks

wscat -c wss://predictasiax.com/ws
> {"method":"SUBSCRIBE","params":["fast_tick"]}

Design principles

Engine-agnostic

Top-level response never leaks AMM vs CLOB. One price field, one size field. meta.fill_venue optional if you need to debug routing.

Deterministic IDs

Market IDs are m_<sha256[0:16]> — idempotent create. Repeat POST /v1/markets returns the same market.

Web3 privacy first

Email, phone, IP stripped from external responses by default. Self-view paths (/v1/account) preserve. X-PII-Redacted header always present.

Money as string

USDT 6dp, BTC 8dp, ETH 18dp — never JavaScript numbers (loses precision). "1000.234567" not 1000.234567.

Envelope + snake_case

{ok, data, meta} on every canonical response. Deep snake_case keys. Timestamps have *_at_ms sibling for easy Date construction.

Chain-agnostic future

Every core table has chain_data JSONB nullable — reserved for on-chain settlement metadata when we ship Base L2.

Authentication

API Key sk_live_* sk_test_*

Send X-Api-Key: sk_live_... header. Simple auth for machine-to-machine, creator profiles, aggregators. Wrong-env key returns 401 WRONG_ENV_KEY.

HMAC (Polymarket-compatible)

5 headers: POLY_ACCESS_KEY, POLY_TIMESTAMP, POLY_PASSPHRASE, POLY_SIGNATURE. Signature = base64(HMAC-SHA256(secret, ts + method + path + body)).

Session Bearer

Authorization: Bearer <session_token> — for browser / mobile client flows. Get token via POST /api/auth/login. Not intended for machine partners.

Rate limits

Per API key, sliding-window. Response headers X-RateLimit-Remaining and Retry-After (on 429) tell you the state.

Production sk_live_*

60 req/min read · 30 req/min trade · 10 req/min create.
Upgrade tier via partner agreement.

Sandbox sk_test_*

10× production baseline. Load-test partners upgradable to 50×. Circuit breaker at 80% VM CPU regardless of tier.