# United Market Docs

## Docs

- [Fees & Referrals](https://docs.unitedmarket.ai/fees.md): Trading, claim, and referral fee structure.
- [Refresh session](https://docs.unitedmarket.ai/testnet/api-reference/authentication/refresh-session.md): Rotates a refresh token and returns a new access token.
- [Request SIWE nonce](https://docs.unitedmarket.ai/testnet/api-reference/authentication/request-siwe-nonce.md): Generates a nonce for Sign-In with Ethereum.
- [Verify SIWE signature](https://docs.unitedmarket.ai/testnet/api-reference/authentication/verify-siwe-signature.md): Verifies a SIWE message and returns session tokens.
- [Get market group](https://docs.unitedmarket.ai/testnet/api-reference/discovery/get-market-group.md): Returns one market group by slug.
- [Get tag](https://docs.unitedmarket.ai/testnet/api-reference/discovery/get-tag.md): Returns one tag.
- [List market groups](https://docs.unitedmarket.ai/testnet/api-reference/discovery/list-market-groups.md): Returns public market groups.
- [List tags](https://docs.unitedmarket.ai/testnet/api-reference/discovery/list-tags.md): Returns public market tags.
- [Get market](https://docs.unitedmarket.ai/testnet/api-reference/markets/get-market.md): Returns public details for a single market.
- [Get market orderbook](https://docs.unitedmarket.ai/testnet/api-reference/markets/get-market-orderbook.md): Returns the current orderbook for a market.
- [Get market price history](https://docs.unitedmarket.ai/testnet/api-reference/markets/get-market-price-history.md): Returns price history for charting.
- [Get market ticker](https://docs.unitedmarket.ai/testnet/api-reference/markets/get-market-ticker.md): Returns best bid, best ask, and midpoint values for market outcomes.
- [Get trading snapshot](https://docs.unitedmarket.ai/testnet/api-reference/markets/get-trading-snapshot.md): Returns the market, orderbook, and trading data needed to render a market trading page.
- [List market trades](https://docs.unitedmarket.ai/testnet/api-reference/markets/list-market-trades.md): Returns recent trades for a market.
- [List markets](https://docs.unitedmarket.ai/testnet/api-reference/markets/list-markets.md): Returns public markets with optional filtering and pagination.
- [Cancel all market orders](https://docs.unitedmarket.ai/testnet/api-reference/orders/cancel-all-market-orders.md): Cancels open orders for the specified market and authenticated account. Requires SIWE bearer auth.
- [Cancel market order](https://docs.unitedmarket.ai/testnet/api-reference/orders/cancel-market-order.md): Cancels one order by order hash. Requires SIWE bearer auth and order ownership.
- [Get account balance](https://docs.unitedmarket.ai/testnet/api-reference/orders/get-account-balance.md): Returns collateral balance, amount locked in open orders, and available collateral.
- [Get order](https://docs.unitedmarket.ai/testnet/api-reference/orders/get-order.md): Returns one order by order hash.
- [List orders](https://docs.unitedmarket.ai/testnet/api-reference/orders/list-orders.md): Lists orders, optionally filtered by account and status.
- [Submit signed order](https://docs.unitedmarket.ai/testnet/api-reference/orders/submit-signed-order.md): Submits an EIP-712 signed order for a market. SIWE login is optional for this route; the order signature is still required.
- [API Overview](https://docs.unitedmarket.ai/testnet/api-reference/overview.md): Public backend API conventions and authentication.
- [Get comment counts](https://docs.unitedmarket.ai/testnet/api-reference/social/get-comment-counts.md): Returns comment counts for one or more markets.
- [Get current user PnL](https://docs.unitedmarket.ai/testnet/api-reference/social/get-current-user-pnl.md): Returns the current PnL snapshot for a user.
- [Get PnL leaderboard](https://docs.unitedmarket.ai/testnet/api-reference/social/get-pnl-leaderboard.md): Returns the public realized PnL leaderboard.
- [Get user](https://docs.unitedmarket.ai/testnet/api-reference/social/get-user.md): Returns a public user profile by wallet address, user id, or username.
- [Get user PnL history](https://docs.unitedmarket.ai/testnet/api-reference/social/get-user-pnl-history.md): Returns historical PnL data for a user.
- [List market comments](https://docs.unitedmarket.ai/testnet/api-reference/social/list-market-comments.md): Returns public comments for a market.
- [Search users](https://docs.unitedmarket.ai/testnet/api-reference/social/search-users.md): Searches public user profiles.
- [Check Market Data](https://docs.unitedmarket.ai/testnet/check-market.md): Load markets, market detail, orderbooks, tickers, price history, and trades on Testnet.
- [Connect to WebSocket](https://docs.unitedmarket.ai/testnet/connect-websocket.md): Subscribe to live testnet market updates with Socket.IO.
- [Testnet Contracts](https://docs.unitedmarket.ai/testnet/contracts.md): Testnet contract addresses for United Market.
- [Testnet](https://docs.unitedmarket.ai/testnet/index.md): Testnet integration details for United Market.
- [Place an Order](https://docs.unitedmarket.ai/testnet/place-order.md): Submit an EIP-712 signed order on Testnet.
- [Sign In & Trade](https://docs.unitedmarket.ai/testnet/sign-in-and-trade.md): Sign in with SIWE, then place or cancel orders on Testnet.

## OpenAPI Specs

- [testnet-openapi](https://docs.unitedmarket.ai/api-spec/testnet-openapi.yaml)
- [mainnet-openapi](https://docs.unitedmarket.ai/api-spec/mainnet-openapi.yaml)
- [public-openapi](https://docs.unitedmarket.ai/api-spec/public-openapi.yaml)