Skip to main content

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.
NetworkBase URL
Mainnethttps://backend.themarketunited.com
Testnethttps://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:
  1. Load GET /markets/{id}/trading when the user opens the market page.
  2. Subscribe to WebSocket updates using the market conditionId.
  3. 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.