Introduction - United Market Docs

United Market is a prediction market platform built on the Gnosis Conditional Tokens Framework. Users trade binary outcome tokens through a central limit order book and settle fills on-chain. These docs cover the public integration surface for partners, traders, market makers, and frontend clients.

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

Base URL

Service	URL
REST API	`https://api.unitedmarket.ai`
Socket.IO (recommended realtime)	`https://api.unitedmarket.ai`
CLOB WebSocket (direct, advanced)	`wss://clob.unitedmarket.ai/ws`

Public API Surface

Use the backend API for public integrations. The backend is the supported gateway for market data, trading, order management, user authentication, and real-time events.

Area	Public Endpoints
Markets	Market discovery, market detail, orderbooks, tickers, price history, and trades
Orders	Signed order submission, cancellation, order listing, and order detail
Balances	Available collateral after open-order locks
Authentication	SIWE nonce, verification, and refresh
Discovery	Tags and market groups
Social & Profiles	Comments, user search, public profiles
Leaderboard	PnL leaderboard and user PnL history
Realtime	Socket.IO market rooms and live update events (or the direct CLOB WebSocket for advanced consumers)

Quick Start

curl "https://api.unitedmarket.ai/markets"

Use HTTPS when calling the API from browsers or the docs playground. HTTP redirects to HTTPS and may be blocked by hosted docs as mixed content.

Next Steps

Review Contracts for deployed addresses and trading approvals.
Review Fees & Referrals for platform fees.
Follow Check Market Data to load market data.
Follow Sign In & Trade to authenticate with SIWE.
Follow Place an Order to submit a signed order.
Follow Connect to WebSocket for live market updates.
Create an API Key for programmatic access.
Open API Overview for the Swagger-style API reference and playground.