Documentation Index
Fetch the complete documentation index at: https://unitedmarket.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Use the backend REST API to read market data.
| Network | Base URL |
|---|
| Mainnet | https://backend.themarketunited.com |
| Testnet | https://backend-develop.themarketunited.com |
The examples below use mainnet. Replace the base URL with testnet when testing against develop markets.
United Market is currently in sandbox/development stage. All funds, balances, markets, and trades are for testing only and do not represent real money.
List Markets
curl "https://backend.themarketunited.com/markets"
You can use market list responses to build discovery pages, category pages, and search results.
Get Market Detail
curl "https://backend.themarketunited.com/markets/{id}"
Market detail includes public market metadata such as the question, outcomes, condition id, status, and trading information.
Get Trading Snapshot
curl "https://backend.themarketunited.com/markets/{id}/trading"
Use the trading snapshot for market pages. It returns the market plus trading data clients usually need before rendering an order ticket.
Get Orderbook
curl "https://backend.themarketunited.com/markets/{id}/orderbook"
Use this endpoint to load or refresh canonical orderbook state. A common pattern is:
- Load
GET /markets/{id}/trading when the user opens the market page.
- Subscribe to WebSocket updates using the market
conditionId.
- Refetch
GET /markets/{id}/orderbook after orderbook:update if local state needs to recover.
Get Ticker
curl "https://backend.themarketunited.com/markets/{id}/ticker"
Ticker data includes best bid, best ask, and midpoint values for market outcomes.
Get Price History
curl "https://backend.themarketunited.com/markets/{id}/price-history?timeframe=1d"
Use price history for charts and historical market views.
Get Recent Trades
curl "https://backend.themarketunited.com/markets/{id}/trades?limit=20"
Use trades for activity feeds, fills tables, and public market history.