> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unitedmarket.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Public developer documentation for United Market.

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.

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

## 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

```bash theme={null}
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](/contracts) for deployed addresses and trading approvals.
* Review [Fees & Referrals](/fees) for platform fees.
* Follow [Check Market Data](/guides/check-market) to load market data.
* Follow [Sign In & Trade](/guides/sign-in-and-trade) to authenticate with SIWE.
* Follow [Place an Order](/guides/place-order) to submit a signed order.
* Follow [Connect to WebSocket](/guides/connect-websocket) for live market updates.
* Create an [API Key](/guides/api-keys) for programmatic access.
* Open [API Overview](/api-reference/overview) for the Swagger-style API reference and playground.