API Overview - United Market Docs

The public API is served by the United Market backend. Use this API for market data, trading, order status, authentication, user profiles, comments, leaderboards, and real-time subscriptions. Only the public backend integration surface is documented here.

United Market is now live on BNB Smart Chain mainnet. We just launched — start trading on-chain prediction markets today.

Calling Endpoints

Use HTTPS in the playground and browser clients. The HTTP endpoints redirect to HTTPS, which can make requests appear to fail from hosted docs. Some user-specific actions require SIWE authentication and a bearer token. Trading actions require EIP-712 order signatures.

Auth	Header	Used For
Bearer token	`Authorization: Bearer <token>`	User-specific actions such as profile updates and posting comments.
Signed order	EIP-712 `signature` in the order payload	Trading actions. Backend auth does not replace order signing.

Open any endpoint page in this section to use the interactive playground.

Endpoint Groups

Group	Endpoints
Markets	Market discovery, market detail, orderbook, ticker, price history, trades
Fees	Effective per-market trading fee rate
Orders	Submit signed orders, cancel orders, list orders, get order detail
Balances	Available collateral after open-order locks
Auth	SIWE nonce, verify, refresh
Discovery	Tags and market groups
Social	Comments and comment counts
Users	Public profiles and search
PnL	Leaderboard, historical PnL, current PnL
Referral	Referral code, attribution, and reward summary

Common Conventions

Amounts are usually returned as raw token units. Collateral uses the collateral token decimals.
Order identifiers are orderHash values derived from the signed EIP-712 order.
Public orders use the zero address as taker.
Market rooms and real-time events are keyed by conditionId.
Trading fees are quoted in basis points. Read a market’s effective rate from GET /markets/{id}/fee and sign it as the order’s feeRateBps. See Fees & Referrals.