API Overview

Public backend API conventions and authentication.

The public API is served by the backend selected in the Testnet docs version.

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. Use the top navigation to switch between Testnet and Mainnet API references.

United Market is currently in sandbox/development stage. All funds, balances, markets, and trades are for testing only and do not represent real money.

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 for the selected network.

Endpoint Groups

Group	Endpoints
Markets	Market discovery, market detail, orderbook, ticker, price history, trades
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

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.