Advanced: Direct REST & WebSocket API

For custom code and low-level integrations that call RapidX directly, without the CLI or MCP layer.

Most participants should use the CLI or MCP — see 01-quickstart.md. This document is for cases where you need direct HTTP or WebSocket access: performance-critical bots, languages without Node.js, or custom tooling.

Official API docs: get-account-list

---

Authentication

Official docs →

Required Headers (REST)

REST Signature Algorithm

1. Sort request parameters alphabetically by key:
   sorted_payload = "key1=val1&key2=val2&..."

2. Append "&" + timestamp:
   payload = sorted_payload + "&" + timestamp
   (no parameters: payload = "&" + timestamp)

3. HMAC-SHA256 with your Secret Key, hex-encoded:
   signature = HMAC-SHA256(secret_key, payload).hexdigest()

Python example:

import hmac, hashlib, time

def sign(params: dict, secret_key: str):
    timestamp = str(int(time.time()))
    sorted_payload = "&".join(f"{k}={v}" for k, v in sorted(params.items()))
    payload = (sorted_payload + "&" if sorted_payload else "&") + timestamp
    sig = hmac.new(secret_key.encode(), payload.encode(), hashlib.sha256).hexdigest()
    return sig, timestamp

WebSocket Authentication Signature

Different from REST — used for the private WebSocket login:

message = timestamp + "GET" + "/users/self/verify"
sign = HMAC-SHA256(secret_key, message).hexdigest()

---

REST API Endpoints

Base URL: https://api.ltp-contest.com

For leaderboard/ranking data, see Track A Leaderboard API (GET /api/v1/tracka/ranking/self) and Track B Ranking — Self Query (GET /api/v1/trackb/ranking/self).

Account & Assets

Orders

Place order fields:

Order states: NEW → OPEN → PARTIALLY_FILLED → FILLED / CANCELLED / REJECTED

For algo orders (TP/SL, TWAP, VWAP — conditional trigger orders), see Algo Orders.

Positions

Market Data (RapidX)

Rate Limits

For full rate limits and endpoint details, see the official API documentation: https://apidocliquidity.readme.io/reference/place-order

REST Response Format

{
  "code": 200000,
  "message": "Success",
  "data": { ... }
}

code: 200000 = success. Any other value is an error. Error codes →

---

WebSocket

Connection Hosts

The competition hosts resolve to the official production API.

Market Data WebSocket

Market Data overview →

• URL: wss://mds.ltp-contest.com/marketdata/v2/public
• Supported exchanges: BINANCE / OKX
• Compression: GZIP is enabled by default. Append ?binary=false to the URL to receive plain-text JSON frames. In Python, decompress GZIP frames with zlib.decompress(data, zlib.MAX_WBITS | 16).

Authentication (optional)

Unauthenticated connections are subject to lower rate limits. To authenticate, send a login message after connecting:

{
  "action": "login",
  "args": { "apiKey": "YOUR_ACCESS_KEY", "timestamp": "1778140847", "sign": "..." }
}

Field naming differs by message type: login uses action / args (object); subscribe / unsubscribe use event / arg (array). Timestamp: the Market Data WS accepts both 10-digit (seconds) and 13-digit (milliseconds) timestamps. The private (User Data) WS only accepts seconds.

Signature:

message = timestamp + "GET" + "/users/self/verify"
sign = HMAC-SHA256(secret_key, message).hexdigest()

Success response:

{ "event": "login", "code": "200000", "msg": "success" }

Rate Limits

• Subscribe rate: max 50 subscribe/unsubscribe requests per IP per second; exceeding returns error 11260.
• Limits are counted by trading pair, not by channel — subscribing BBO + TICKER + TRADE for the same symbol counts as 1 pair.

Heartbeat

The server disconnects after 60 seconds of inactivity. Send {"ping": <timestamp_ms>} every ~20 seconds; the server replies {"pong": <timestamp_ms>}.

Symbol Format

{EXCHANGE}_{TYPE}_{BASE}_{QUOTE} — EXCHANGE: BINANCE / OKX; TYPE: SPOT / PERP. Example: BINANCE_PERP_BTC_USDT.

Subscribe / Unsubscribe

Channel names are case-sensitive and must be uppercase.

{
  "event": "subscribe",
  "arg": [
    { "channel": "BBO", "sym": "BINANCE_PERP_BTC_USDT" },
    { "channel": "TRADE", "sym": "OKX_PERP_BTC_USDT" }
  ]
}

Available Channels

Error Codes

User Data WebSocket

User Data Streams overview →

• URL: wss://wss.ltp-contest.com/v1/private
• Supported exchanges: BINANCE / OKX
• Authentication required. After login the server auto-pushes orders, trades, assets, positions, and margin-call updates; the same connection can place, replace, and cancel orders.

Login

{
  "action": "login",
  "args": { "apiKey": "YOUR_ACCESS_KEY", "timestamp": "1778140847", "sign": "..." }
}

• Timestamp: only 10-digit seconds are accepted; a 13-digit millisecond timestamp returns 601016.
• Success: {"event":"login","code":0,"msg":""}
• Failure: {"event":"login","code":601009,"msg":"Login failed"}
• args.onlyTrade (optional, bool): when true, the connection is restricted to order operations only and no data streams are pushed.

Signature:

message = timestamp + "GET" + "/users/self/verify"
sign = HMAC-SHA256(secret_key, message).hexdigest()

Order Actions

{ "id": "p1", "action": "place_order",   "args": { ... } }
{ "id": "a1", "action": "replace_order", "args": { "orderId": "...", "replacePrice": "64000" } }
{ "id": "c1", "action": "cancel_order",  "args": { "orderId": "..." } }

Orders push channel — auto-subscribed after login. User data streams →

{
  "channel": "Orders",
  "data": {
    "orderId": "1234567890123456",
    "clientOrderId": "agent-001",
    "orderState": "FILLED",
    "executedQty": "0.001",
    "executedAvgPrice": "65000"
  }
}

Rate Limits

Heartbeat

The server disconnects after 30 seconds of inactivity. Send the raw string ping every ~10 seconds; the server replies pong.

Available Pages

• User Data overview · User Data Streams
• Place Order · Replace Order
• Cancel Order · Cancel Orders

For full rate limits and endpoint details, see the official API documentation: https://apidocliquidity.readme.io/reference/place-order

For all News Feed APIs (REST + WebSocket), see News Feed.

---

Symbol Format

{EXCHANGE}_{TYPE}_{BASE}_{QUOTE}

Channels marked "Perpetual only" reject SPOT symbols with error 11100.

---

Common Error Codes

Full error code reference →

REST

Market Data WebSocket

---