# Bravado

## Docs

- [Infrastructure layer for Prediction Markets](https://docs.bravadotrade.com/introduction.md): Bravado provides REST APIs for order execution, copy-trading, and analytics across prediction markets. Build trading bots, dashboards, and social trading features.
- [Get Started with Bravado in 5 Minutes](https://docs.bravadotrade.com/quickstart.md): Make your first Bravado API call: verify your credentials, check your balances, and place a market order in under 5 minutes.
- [Authenticate Requests to the Bravado API](https://docs.bravadotrade.com/authentication.md): Bravado uses Bearer token authentication. Learn how to pass your API key, understand API key scopes, and handle authentication errors correctly.
- [Build with AI](https://docs.bravadotrade.com/build-with-ai.md): Point your coding agents at the Bravado docs, use llms.txt, and integrate the Bravado MCP server for AI-native development.
- [Supported Prediction Markets](https://docs.bravadotrade.com/markets/overview.md): Bravado provides a single API surface across multiple prediction markets. Compare venue coverage and which Bravado products are available on each.
- [Polymarket on Bravado: Coverage and Supported Features](https://docs.bravadotrade.com/markets/polymarket/overview.md): Polymarket is the largest prediction market by volume, running on Polygon. Bravado supports it across the Trade, Copytrade, Data, and UMA APIs.
- [Trade API on Polymarket](https://docs.bravadotrade.com/markets/polymarket/trade-api.md): Order execution and position management on Polymarket via the Bravado Trade API v2, including all eight supported order types.
- [Copytrade API on Polymarket](https://docs.bravadotrade.com/markets/polymarket/copytrade-api.md): Mirror any Polymarket wallet's fills in real time with configurable sizing modes, filters, and risk controls.
- [Combos API on Polymarket](https://docs.bravadotrade.com/markets/polymarket/combos-api.md): Buy multi-leg parlay positions across 2 to 10 Polymarket markets in a single on-chain position, priced by RFQ.
- [Data API on Polymarket](https://docs.bravadotrade.com/markets/polymarket/data-api.md): Wallet-level PnL, leaderboards, trade logs, and tax statements for any Polymarket address, derived from on-chain Polygon settlement.
- [UMA Resolution on Polymarket](https://docs.bravadotrade.com/markets/polymarket/uma-resolution.md): How Polymarket markets settle through UMA's Optimistic Oracle, why a concluded event is not immediately redeemable, and how disputes extend that window.
- [Predict.fun on Bravado: Coverage and Supported Features](https://docs.bravadotrade.com/markets/predict-fun/overview.md): Predict.fun is a prediction market on BNB Chain, collateralised in USDT. Bravado supports it through the Trade API v2 by passing venue: predictfun.
- [Trade API on Predict.fun](https://docs.bravadotrade.com/markets/predict-fun/trade-api.md): Order execution and position management on Predict.fun via the Bravado Trade API v2. Add venue: predictfun to route to Predict.fun.
- [Copytrade API on Predict.fun](https://docs.bravadotrade.com/markets/predict-fun/copytrade-api.md): Mirroring a leader wallet's fills on Predict.fun via Bravado. Support status is pending confirmation.
- [Data API on Predict.fun](https://docs.bravadotrade.com/markets/predict-fun/data-api.md): Wallet PnL, leaderboards, and trade history on Predict.fun via Bravado. Support status is pending confirmation.
- [Data API: Trader Analytics and Performance Metrics](https://docs.bravadotrade.com/products/data-api.md): The Bravado Data API provides on-chain PnL metrics, leaderboards, trade history, and tax statements for any Polymarket wallet address.
- [GET /healthz: Data API Liveness Probe](https://docs.bravadotrade.com/api/analytics/healthz.md): Unauthenticated liveness probe for the Bravado Data API.
- [GET /leaderboard: PnL Leaderboard](https://docs.bravadotrade.com/api/analytics/leaderboard.md): Returns traders ranked by realized PnL for the requested rolling window, computed under PMWAS.
- [GET /leaderboard/volume: Polymarket Volume Leaderboard](https://docs.bravadotrade.com/api/analytics/leaderboard-volume.md): Returns traders ranked by USDC trading volume for the requested rolling window.
- [GET /traders/{address}: Trader Profile Summary](https://docs.bravadotrade.com/api/analytics/trader.md): Wallet performance summary: PnL, volume, position counts, streaks, and identity fields.
- [GET /traders/{address}/pnl: Cumulative PnL Time Series](https://docs.bravadotrade.com/api/analytics/trader-pnl.md): Cumulative PnL time series for a wallet, suitable for plotting an equity curve.
- [GET /traders/{address}/positions: All Positions](https://docs.bravadotrade.com/api/analytics/trader-positions.md): Open and closed positions for the wallet, paginated.
- [GET /traders/{address}/positions/active: Open Positions](https://docs.bravadotrade.com/api/analytics/trader-positions-active.md): The wallet's currently open positions.
- [GET /traders/{address}/positions/closed: Closed Positions](https://docs.bravadotrade.com/api/analytics/trader-positions-closed.md): The wallet's closed positions.
- [GET /traders/{address}/trades: Trade Log](https://docs.bravadotrade.com/api/analytics/trader-trades.md): Paginated log of all trade events for a wallet in reverse chronological order.
- [GET /traders/{address}/categories: Per-Category Breakdown](https://docs.bravadotrade.com/api/analytics/trader-categories.md): Per-category PnL and volume breakdown for the wallet.
- [GET /traders/{address}/usdc-balance: On-Chain USDC Balance](https://docs.bravadotrade.com/api/analytics/trader-usdc-balance.md): Current on-chain USDC collateral balance for a Polygon wallet.
- [GET /traders/{address}/statements: Full PMWAS Statement](https://docs.bravadotrade.com/api/analytics/trader-statements.md): Complete §20 PMWAS statement containing all eight reports (R1–R8) for a wallet.
- [GET /traders/{address}/statements/r1: R1 Dispositions](https://docs.bravadotrade.com/api/analytics/trader-statements-r1.md): Paginated R1 Form-8949-style disposition rows for heavy wallets.
- [GET /traders/{address}/metrics: Performance Metrics (R5/R6/R7)](https://docs.bravadotrade.com/api/analytics/trader-metrics.md): Low-latency R5/R6/R7 performance and fee metrics without the full R1 disposition set.
- [GET /traders/{address}/reconciliation: R8 Certificate](https://docs.bravadotrade.com/api/analytics/trader-reconciliation.md): R8 reconciliation certificate verifying internal consistency of the wallet's statement.
- [GET /traders/{address}/tax-report: Per-Year Tax Summary](https://docs.bravadotrade.com/api/analytics/trader-tax-report.md): Per-calendar-year tax summary with short-term and long-term capital gains and income breakdown.
- [GET /trades: Trade Log by Query Parameter](https://docs.bravadotrade.com/api/analytics/trades.md): Trade log for a wallet supplied as a query parameter. Alternative to /traders/{address}/trades.
- [GET /entity/{owner}: Multi-Wallet Entity Rollup](https://docs.bravadotrade.com/api/analytics/entity.md): Aggregates R5/R6/R7 metrics across all controlled wallets registered under a beneficial owner.
- [Trade API: Order Types, Execution, and Positions](https://docs.bravadotrade.com/products/trade-api.md): The Bravado Trade API covers the full order lifecycle on supported prediction markets: eight order types, bracket orders, and position management including redeem, split, and merge.
- [Place and Cancel Orders via the Bravado Trade API v2](https://docs.bravadotrade.com/api/trade/orders.md): Place single and batch Polymarket orders: LIMIT, MARKET, TWAP, ICEBERG, PEGGED, and stop variants, and cancel them via the Bravado API.
- [Position Management API: Redeem, Split, and Merge](https://docs.bravadotrade.com/api/trade/positions.md): GET /v2/trade/positions, POST /v2/trade/positions/redeem, /split, and /merge endpoints for managing Polymarket outcome token positions.
- [Managed Strategies API: TWAP, Iceberg, Pegged, Stops](https://docs.bravadotrade.com/api/trade/strategies.md): List and cancel long-running managed order strategies: TWAP, Iceberg, Pegged, Stop-Loss, and Trailing Stop, on the Bravado Trade API v2.
- [Account Snapshot, Balances, and Activity API Reference](https://docs.bravadotrade.com/api/trade/account.md): GET /v2/trade/account, /balances, /balances/withdrawable, and /activity endpoints for inspecting your Bravado integration account.
- [Withdraw Collateral to an External Polygon Address](https://docs.bravadotrade.com/api/trade/withdraw.md): POST /v2/trade/withdraw transfers pUSD or any ERC20 token from your deposit wallet to an external Polygon address. Requires trade.withdraw scope.
- [Copytrade API: Mirror a Leader Wallet's Fills](https://docs.bravadotrade.com/products/copytrade-api.md): Bravado's Copytrade API mirrors a leader trader's fills on a follower's wallet in real time, with configurable sizing modes and risk controls.
- [Copytrade Subscription Endpoints API Reference](https://docs.bravadotrade.com/api/copytrade/subscriptions.md): POST, GET, PATCH, and DELETE endpoints for managing Bravado copytrade subscriptions, including sizing config, filters, and risk controls.
- [Copytrade Simulation Portfolio API Reference](https://docs.bravadotrade.com/api/copytrade/simulation.md): GET /v2/trade/copytrade/simulation and POST /simulation/reset: view and reset the paper trading portfolio for a copytrade subscription.
- [Combos API: Multi-Leg Parlay Trading on Bravado](https://docs.bravadotrade.com/api/combos/overview.md): The Bravado Combos API lets you buy multi-leg parlay positions across 2–10 markets via RFQ. Requires the trade.combos scope to quote, accept, and redeem.
- [Combo Quote, Accept, and Redeem API Reference](https://docs.bravadotrade.com/api/combos/quote-accept-redeem.md): POST /v2/trade/combo/quote, /combo/accept, /combo/redeem, and GET /combo/positions: full reference for Bravado's multi-leg parlay API.
- [UMA API: Optimistic Oracle Resolution Data](https://docs.bravadotrade.com/products/uma-api.md): Query how Polymarket markets are resolved through UMA's Optimistic Oracle, including proposals, disputes, and final settlement outcomes.
- [Trading Terminals and Front Ends](https://docs.bravadotrade.com/use-cases/terminals.md): Build a full trading terminal for prediction markets: order entry, live positions, leaderboards, and copy-trading from a single API surface.
- [Algorithmic Trading Bots for Prediction Markets](https://docs.bravadotrade.com/use-cases/algorithmic-trading-bots.md): Execute algorithmic strategies on thin prediction-market order books with Bravado's TWAP, Iceberg, and Pegged order types.
- [Copy-Trading and Social Trading Products](https://docs.bravadotrade.com/use-cases/copy-trading.md): Build a copy-trading or social trading product on prediction markets with the Bravado Copytrade API.
- [Portfolio Dashboards and PnL Tracking](https://docs.bravadotrade.com/use-cases/portfolio-dashboards.md): Build portfolio dashboards and PnL trackers for prediction market wallets with the Bravado Data API.
- [AI Agents Trading Prediction Markets](https://docs.bravadotrade.com/use-cases/ai-agents.md): Give AI agents programmatic access to prediction market trading with the Bravado APIs and MCP server.
- [Quant Research and Historical Analysis](https://docs.bravadotrade.com/use-cases/quant-research.md): Pull historical prediction market trade, position, and PnL data for quant research and backtesting with the Bravado Data API.
- [Tax and Accounting Tooling for Prediction Market Traders](https://docs.bravadotrade.com/use-cases/tax-accounting-tooling.md): Build tax and accounting products for prediction market traders with the Bravado Data API tax statement endpoints.
- [Bravado SDKs](https://docs.bravadotrade.com/sdk/overview.md): Typed client libraries for the Bravado APIs in TypeScript and Python.
- [Bravado TypeScript SDK](https://docs.bravadotrade.com/sdk/typescript.md): Install and use the typed Bravado TypeScript SDK for the Trade, Copytrade, and Data APIs.
- [Bravado Python SDK](https://docs.bravadotrade.com/sdk/python.md): Install and use the typed Bravado Python SDK for the Trade, Copytrade, and Data APIs.
- [Bravado Trade API v2: Endpoints and Integration Guide](https://docs.bravadotrade.com/api/trade/overview.md): The Bravado Trade API v2 provides consolidated order execution, position management, balances, and user provisioning for Polymarket on Polygon.
- [Liveness probe](https://docs.bravadotrade.com/api-reference/tradehealth/liveness-probe.md): Returns ok+ts when the partner-api module is reachable. Public; no auth.
- [OpenAPI 3 spec](https://docs.bravadotrade.com/api-reference/tradehealth/openapi-3-spec.md): Returns the OpenAPI 3 spec for /v1/trade endpoints (tags trade.*). Public; no auth.  Admin routes are excluded — they are internal-only.
- [Account snapshot](https://docs.bravadotrade.com/api-reference/traderead/account-snapshot.md): Returns the integration, binding, api key, wallet (EOA + Safe), and the builder code resolved for this key. Useful as the first call after onboarding to verify credentials and inspect quotas.
- [List positions](https://docs.bravadotrade.com/api-reference/traderead/list-positions.md): Returns the user's positions sourced from the Polymarket data-api, normalised to snake_case with numeric fields encoded as JSON strings. Use `?status=active` (default) for currently-held positions with a live mark price and on-chain ERC1155 enrichment, or `?status=closed` for fully-sold positions wi…
- [List activity timeline](https://docs.bravadotrade.com/api-reference/traderead/list-activity-timeline.md): Returns the user's trade activity sourced from the Polymarket data-api: trades (BUY/SELL), redemptions, liquidity rewards, maker rebates, referral rewards, splits, merges, conversions, deposits, and withdrawals. Pagination via opaque `cursor`.
- [Collateral balances](https://docs.bravadotrade.com/api-reference/traderead/collateral-balances.md): Returns pUSD (active V2 collateral) and USDC.e (legacy, wrappable) for the bound user's Polymarket Safe wallet.  Decimal values as JSON strings with 6-decimal precision.  With ?venue=predictfun the `pusd` field carries the venue collateral (USDT on BNB) instead.
- [List open orders](https://docs.bravadotrade.com/api-reference/traderead/list-open-orders.md): Open CLOB orders for the bound user, optionally filtered by ?token_id. is_take_profit / is_stop_loss / is_pegged reflect the partner-managed-order joins: TP at creation, SL post- trigger (executionOrderId), Pegged while the runner is actively maintaining it (current_order_id). Pre-trigger SLs are co…
- [List withdrawable ERC20 balances](https://docs.bravadotrade.com/api-reference/traderead/list-withdrawable-erc20-balances.md): Returns the bound user's ERC20 token balances on Polygon (via Allium), scaled to human decimals with zero balances dropped. Shows what can be pulled out with POST /v2/trade/withdraw (pass the token address).
- [List managed strategies (TWAP / Iceberg / Pegged / Stop-Loss / Trailing-Stop)](https://docs.bravadotrade.com/api-reference/traderead/list-managed-strategies-twap-iceberg-pegged-stop-loss-trailing-stop.md): Lists the bound user's partner-created managed strategies, newest first. Optional `status` filter. These are the `record_id` entries returned by POST /v2/trade/order for PEGGED/TWAP/ICEBERG/STOP_LOSS/TRAILING_STOP/TRAILING_BUY types. Pre-trigger stop-losses, trailing stops and trailing buys live ONL…
- [Cancel a single order](https://docs.bravadotrade.com/api-reference/tradecancel/cancel-a-single-order.md): Cancels one CLOB order by id.  Idempotency-Key is optional but recommended.  Order ids that the CLOB doesn't recognise are returned in not_cancelled with reason='unknown'.
- [Cancel a batch of orders](https://docs.bravadotrade.com/api-reference/tradecancel/cancel-a-batch-of-orders.md): Cancels up to 50 orders by id in a single CLOB call.  Idempotency-Key required.  Per-order outcomes are returned individually.
- [Cancel all open orders](https://docs.bravadotrade.com/api-reference/tradecancel/cancel-all-open-orders.md): Cancels every open CLOB order for the bound user.  Idempotency-Key required.  Returns the list of cancelled order ids; an empty list means there were no open orders to cancel.
- [Cancel a managed strategy](https://docs.bravadotrade.com/api-reference/tradecancel/cancel-a-managed-strategy.md): Cancels a TWAP / Iceberg / Pegged / Stop-Loss / Trailing-Stop strategy by its record_id: cancels the live CLOB slice (if any) and marks the record CANCELED. A stop-loss can only be canceled while still PENDING — once triggered the runner is executing it. Idempotent for already-terminal records. Idem…
- [Provision a partner-scoped user](https://docs.bravadotrade.com/api-reference/tradeusers/provision-a-partner-scoped-user.md): Idempotent on (partner_id, partner_user_id). Creates a Privy embedded wallet, deploys the Polymarket Safe via the Bravado relayer, issues CLOB credentials, and binds the user to the calling integration.  Returns 201 on first creation, 200 with `created:false` on subsequent calls for the same partner…
- [Place an order (consolidated)](https://docs.bravadotrade.com/api-reference/tradeexecute/place-an-order-consolidated.md): Single high-level order endpoint. `type` = LIMIT | MARKET | PEGGED | TWAP | ICEBERG. Optional `take_profit` / `stop_loss` brackets attach to a LIMIT/MARKET buy entry (placed after the entry; best-effort — a failing bracket is reported, not rolled back). Idempotency-Key required.
- [Place a batch of limit orders (bid ladder)](https://docs.bravadotrade.com/api-reference/tradeexecute/place-a-batch-of-limit-orders-bid-ladder.md): Places N limit orders at distinct prices in one call (up to 20 rungs). Atomic: if any rung is rejected, every already-placed rung is cancelled before the error surfaces — partners never see a partial ladder. Idempotency-Key required.
- [Redeem a resolved position to pUSD](https://docs.bravadotrade.com/api-reference/tradeexecute/redeem-a-resolved-position-to-pusd.md): Redeems a resolved CTF position back to pUSD collateral. Synchronous: waits for on-chain confirmation and returns the actual payout in `payout_base_units` (6 decimals; 0 for a losing or already-redeemed position). Idempotency-Key required.
- [Split pUSD collateral into a complete outcome set](https://docs.bravadotrade.com/api-reference/tradeexecute/split-pusd-collateral-into-a-complete-outcome-set.md): Splits `amount` pUSD into one share of every outcome of the market (CTF splitPosition). Returns the on-chain tx hash. Idempotency-Key required.
- [Merge a complete outcome set back into pUSD](https://docs.bravadotrade.com/api-reference/tradeexecute/merge-a-complete-outcome-set-back-into-pusd.md): Merges one share of every outcome (`amount` sets) back into pUSD collateral (CTF mergePositions). Returns the on-chain tx hash. Idempotency-Key required.
- [Withdraw pUSD to an external address](https://docs.bravadotrade.com/api-reference/tradewithdraw/withdraw-pusd-to-an-external-address.md): Transfers pUSD collateral from the bound user's deposit wallet to an external address. Returns STATE_PENDING + the broadcast hash if not confirmed within the latency budget (reconcile via /activity). Requires the `trade.withdraw` scope. Idempotency-Key required.
- [List the bound user's active/paused copytrades](https://docs.bravadotrade.com/api-reference/tradecopytrade/list-the-bound-users-activepaused-copytrades.md)
- [Subscribe the bound user to a leader (copytrade)](https://docs.bravadotrade.com/api-reference/tradecopytrade/subscribe-the-bound-user-to-a-leader-copytrade.md): Creates a copytrade subscription for the end-user (resolved from X-Partner-User-Id) that mirrors the leader's fills per the buy/sell sizing config. The copytrade engine executes copied trades on the user's wallet. Idempotency-Key required. 409 if an active copytrade for this leader already exists.
- [Copied-trade execution history for the bound user](https://docs.bravadotrade.com/api-reference/tradecopytrade/copied-trade-execution-history-for-the-bound-user.md)
- [Realized copytrade PnL (24h + lifetime) for the bound user](https://docs.bravadotrade.com/api-reference/tradecopytrade/realized-copytrade-pnl-24h-+-lifetime-for-the-bound-user.md)
- [Paper (simulation) portfolio for the bound user](https://docs.bravadotrade.com/api-reference/tradecopytrade/paper-simulation-portfolio-for-the-bound-user.md): The bound user's simulation paper account: open positions marked to the live CLOB midpoint, realized + unrealized PnL, paper cash and equity. Built from is_simulation fills only; touches no real balance. A position's mark/value/unrealized is null if the midpoint was momentarily unavailable.
- [Cancel (soft-delete) a copytrade](https://docs.bravadotrade.com/api-reference/tradecopytrade/cancel-soft-delete-a-copytrade.md): Idempotency-Key optional on DELETE. History is preserved.
- [Update a copytrade's config (partial)](https://docs.bravadotrade.com/api-reference/tradecopytrade/update-a-copytrades-config-partial.md): All fields optional; only provided fields change.
- [Pause / resume / disable a copytrade](https://docs.bravadotrade.com/api-reference/tradecopytrade/pause-resume-disable-a-copytrade.md)
- [Reset a copytrade's simulation (clear paper fills)](https://docs.bravadotrade.com/api-reference/tradecopytrade/reset-a-copytrades-simulation-clear-paper-fills.md): Deletes this copytrade's paper (simulation) history so the leader can be re-tested from a clean slate. Live fills are never touched. Returns the number of paper fills cleared.
- [Request an RFQ quote for a multi-leg combo](https://docs.bravadotrade.com/api-reference/tradecombos/request-an-rfq-quote-for-a-multi-leg-combo.md): Requests a maker price for a 2–10 leg parlay (RFQ). The returned `expires_at` is ~8.5s out — call /combo/accept with the returned `combo_order_id` + `quote_id` before it, or re-quote. Managed (deposit-wallet) users only. Idempotency-Key required.
- [Accept a live combo quote and execute](https://docs.bravadotrade.com/api-reference/tradecombos/accept-a-live-combo-quote-and-execute.md): Signs and executes the combo at the quoted price. Returns EXECUTED with the on-chain tx hash. A stale/expired quote returns 410 QUOTE_EXPIRED — re-quote, never blind-retry (the price may have moved). Idempotency-Key required.
- [Redeem a resolved-win combo to pUSD](https://docs.bravadotrade.com/api-reference/tradecombos/redeem-a-resolved-win-combo-to-pusd.md): Burns winning combo shares back to pUSD collateral (manual claim). Synchronous — returns the actual `payout_usd`. Only redeems combos resolved in the user's favor. Idempotency-Key required.
- [List the user's combo positions](https://docs.bravadotrade.com/api-reference/tradecombos/list-the-users-combo-positions.md): Returns the bound user's combo (parlay) positions with per-leg detail and status (OPEN | PARTIAL | RESOLVED_WIN | RESOLVED_LOSS).
- [Copytrade API Overview: Mirror Trader Fills on Bravado](https://docs.bravadotrade.com/api/copytrade/overview.md): Subscribe to a leader wallet so trades are automatically mirrored on Bravado with configurable sizing, order filters, and risk controls.
- [Bravado Data API: Polymarket Trader Data Overview](https://docs.bravadotrade.com/api/analytics/overview.md): The Bravado Data API provides on-chain PnL metrics, leaderboards, positions, trade logs, and formal tax statements for Polymarket wallets.
- [Prediction Market API Guides](https://docs.bravadotrade.com/guides/overview.md): Build on prediction markets with the Bravado API: trading bots, terminals, copy trading, analytics dashboards, and tax reporting for Polymarket.
- [Polymarket API Guides](https://docs.bravadotrade.com/guides/polymarket.md): Build on Polymarket with the Bravado API: trading bots, advanced order types, copy trading, terminals, leaderboards, and tax reporting.
- [Predict.fun API Guides](https://docs.bravadotrade.com/guides/predict-fun.md): Guides for building on Predict.fun with the Bravado API. Product coverage is partial and being confirmed.
- [How to Place an Order on Polymarket with the Bravado API](https://docs.bravadotrade.com/guides/place-an-order.md): Place your first Polymarket order through the Bravado API, then shape the same call into all eight order types, attach exits, and find your order afterwards.
- [How to Build a Prediction Market Trading Bot](https://docs.bravadotrade.com/guides/build-a-trading-bot.md): Build a Polymarket trading bot with the Bravado API: reconcile state on startup, compute a delta, execute safely, and survive restarts without doubling your position.
- [How to Build a BTC 5-Minute and 15-Minute Bot on Polymarket](https://docs.bravadotrade.com/guides/btc-5m-15m-bot.md): Build a Polymarket bot for BTC 5-minute and 15-minute up/down markets: Chainlink TWAP settlement, deterministic market discovery, the fee math that decides your edge, and execution through the Bravado API.
- [How to Use Stop-Loss and Take-Profit Orders on Polymarket](https://docs.bravadotrade.com/guides/stop-loss-take-profit.md): Protect a Polymarket position with stop-loss, take-profit, trailing stops, and bracket orders, and understand what exits cannot protect against.
- [How to Execute a Large Position with TWAP and Iceberg Orders](https://docs.bravadotrade.com/guides/large-position-twap-iceberg.md): Work a large position into a thin Polymarket order book using TWAP and Iceberg without moving the price against yourself or showing your hand.
- [How to Quote Both Sides of a Polymarket Market with Split and Merge](https://docs.bravadotrade.com/guides/quote-both-sides-split-merge.md): Split USDC into a complete outcome set to make markets on both sides of a Polymarket question, manage inventory imbalance, and merge back to recover collateral.
- [How to Retry Orders Safely with Idempotency Keys](https://docs.bravadotrade.com/guides/safe-retries-idempotency.md): Use Idempotency-Key so a timed-out Polymarket order can be retried without creating a duplicate position, and know when to use a deterministic key instead.
- [How to Build a Prediction Market Trading Terminal](https://docs.bravadotrade.com/guides/build-a-trading-terminal.md): Build a Polymarket trading terminal with the Bravado API: the four calls on load, order entry, polling budgets, and the position states a UI must not collapse.
- [How to Display Positions and PnL in a Prediction Market App](https://docs.bravadotrade.com/guides/display-positions-and-pnl.md): Render Polymarket positions with correct cost basis, realized versus unrealized PnL, and the four resolution states a two-state model gets wrong.
- [How to Track Order and Strategy State on Bravado](https://docs.bravadotrade.com/guides/track-order-and-strategy-state.md): Why a TWAP does not appear in your open orders, how CLOB orders differ from managed strategies, and how to render and cancel both correctly.
- [How to Provision Sub-Accounts for a White-Label Prediction Market Product](https://docs.bravadotrade.com/guides/white-label-sub-accounts.md): Use a Bravado partner master key to provision end users with their own Polymarket wallets and scoped API keys, without ever holding their credentials.
- [How to Track a Whale Wallet and Mirror Its Trades](https://docs.bravadotrade.com/guides/track-whale-wallet.md): Find a profitable Polymarket trader with the Data API, verify their record properly, then mirror their fills with configurable sizing and risk controls.
- [How to Build a Polymarket Copy Trading Bot](https://docs.bravadotrade.com/guides/copy-trading-bot-50-lines.md): Build a Polymarket copy trading bot with the Bravado API: rank leaders on evidence, subscribe with sizing and risk controls, paper trade it, then go live.
- [How to Build a Polymarket PnL Leaderboard](https://docs.bravadotrade.com/guides/pnl-leaderboard.md): Rank Polymarket traders by realized PnL or volume with the Bravado Data API, build trader profiles, and cache it so you stay inside your rate limit.
- [How to Generate a US Tax Statement for Polymarket Trading](https://docs.bravadotrade.com/guides/us-tax-statement.md): Pull Form-8949-style disposition rows for a Polymarket wallet, reconcile them against an R8 certificate, and export something a preparer can check.
- [Bravado API Errors: Status Codes and Troubleshooting](https://docs.bravadotrade.com/reference/errors.md): HTTP status codes returned by the Bravado API with causes, example responses, and recommended actions for each error type you may encounter.
- [Bravado API Rate Limits, Backoff, and Retry Strategy](https://docs.bravadotrade.com/reference/rate-limits.md): Bravado enforces per-API-key rate limits. Learn your rate limit, how to handle 429 responses, and best practices for building resilient integrations.
- [Bravado API Pagination: Offset, Cursor, and R1 Styles](https://docs.bravadotrade.com/reference/pagination.md): Bravado uses two pagination styles: offset/limit for most endpoints and cursor-based pagination for trade history and activity timelines.
- [Numeric and Timestamp Conventions in the Bravado API](https://docs.bravadotrade.com/reference/numeric-conventions.md): Bravado encodes all numeric values as JSON strings for precision. Learn price units, micro-USDC fields, timestamp formats, and parsing recommendations.
- [Idempotency](https://docs.bravadotrade.com/reference/idempotency.md): Full semantics of Idempotency-Key on the Bravado API: format, retention, replay behavior, and conflict handling.
- [Versioning and Deprecation Policy](https://docs.bravadotrade.com/reference/versioning.md): How the Bravado API is versioned, how long each version is supported, and the notice period before deprecation.
- [Changelog](https://docs.bravadotrade.com/reference/changelog.md): Dated entries for every change to the Bravado API.
- [Status and Uptime](https://docs.bravadotrade.com/reference/status.md): Bravado API status page, uptime history, and incident notifications.

## OpenAPI Specs

- [v2-trade](https://docs.bravadotrade.com/api-reference/openapi/v2-trade.json)