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

# Infrastructure layer for Prediction Markets

> Bravado provides REST APIs for order execution, copy-trading, and analytics across prediction markets. Build trading bots, dashboards, and social trading features.

Bravado is a single API surface across prediction market venues, so you integrate once instead of per-venue. [Polymarket](/markets/polymarket/overview) is supported across every product; see [supported prediction markets](/markets/overview) for coverage by venue.

Create and manage your API keys in the [Bravado Portal](https://portal.bravadotrade.com/).

<CardGroup cols={2}>
  <Card title="Quick Start" icon="zap" href="/quickstart">
    Make your first API call and place a market order in under 5 minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Set up Bearer token auth and understand API key scopes.
  </Card>

  <Card title="API Reference" icon="code" href="/api/trade/overview">
    Full endpoint reference for Trade, Copytrade, and Data APIs.
  </Card>

  <Card title="Build with AI" icon="sparkles" href="/build-with-ai">
    Point your coding agents at Bravado docs, llms.txt, and MCP.
  </Card>
</CardGroup>

## Why Bravado

<CardGroup cols={3}>
  <Card title="Eight order types" icon="arrow-left-right" href="/products/trade-api">
    LIMIT, MARKET, TWAP, ICEBERG, PEGGED, STOP\_LOSS, TAKE\_PROFIT, and TRAILING\_STOP for algorithmic strategies on thin books.
  </Card>

  <Card title="Copy-trading built in" icon="users" href="/api/copytrade/overview">
    Mirror any wallet's fills with proportional, fixed, or capped sizing. No native equivalent on Polymarket.
  </Card>

  <Card title="Tax-grade analytics" icon="chart-line" href="/products/data-api">
    Wallet-level PnL under the Prediction Market Wallet Accounting Standard (PMWAS), with tax statements for realized gains.
  </Card>
</CardGroup>

## Bravado vs. Polymarket's native APIs

| Capability        | Polymarket native | Bravado                                                                        |
| ----------------- | ----------------- | ------------------------------------------------------------------------------ |
| Order types       | LIMIT, MARKET     | LIMIT, MARKET, TWAP, ICEBERG, PEGGED, STOP\_LOSS, TAKE\_PROFIT, TRAILING\_STOP |
| Execution latency | Baseline          | Lower, with server-side execution of advanced order types                      |
| Data accuracy     | Baseline          | PMWAS-standardized PnL and full fill reconciliation                            |
| Copy-trading      | Not available     | First-class Copytrade API with configurable sizing modes                       |
| Historical PnL    | Recent activity   | Full wallet history from first trade, with cost-basis tracking                 |
| Tax reporting     | Not available     | Tax statements per wallet, US-format                                           |
| Sub-accounts      | Not available     | Master-key flow for white-label integrations                                   |
| Idempotency       | Not enforced      | Required `Idempotency-Key` on every mutating request                           |

## API surfaces

| API               | Base URL                                                          | What it does                                            |
| ----------------- | ----------------------------------------------------------------- | ------------------------------------------------------- |
| **Trade API v2**  | `https://bravado-api-k7kaq.ondigitalocean.app/v2/trade`           | Order execution, positions, balances, user provisioning |
| **Copytrade API** | `https://bravado-api-k7kaq.ondigitalocean.app/v2/trade/copytrade` | Mirror fills from top traders with configurable sizing  |
| **Data API**      | `https://bravado-api-k7kaq.ondigitalocean.app`                    | Leaderboards, wallet PnL, trade logs, tax statements    |

## Your first request

The Data API is public read-only, run this with zero setup. Replace `demo` with your own key from the [portal](https://portal.bravadotrade.com/).

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://bravado-api-k7kaq.ondigitalocean.app/traders/0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b/pnl" \
    -H "Authorization: Bearer demo"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    "https://bravado-api-k7kaq.ondigitalocean.app/traders/0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b/pnl",
    { headers: { Authorization: "Bearer demo" } },
  );

  const pnl = await res.json();
  console.log(pnl);
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://bravado-api-k7kaq.ondigitalocean.app/traders/0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b/pnl",
      headers={"Authorization": "Bearer demo"},
  )
  print(res.json())
  ```
</CodeGroup>

## Use cases

<CardGroup cols={3}>
  <Card title="Trading Bots" icon="bot" href="/use-cases/algorithmic-trading-bots">
    Automate strategies with TWAP, iceberg, pegged, and bracket orders.
  </Card>

  <Card title="Copy Trading" icon="users-round" href="/use-cases/copy-trading">
    Mirror top traders automatically with configurable sizing.
  </Card>

  <Card title="Portfolio Dashboards" icon="chart-pie" href="/use-cases/portfolio-dashboards">
    Surface leaderboards, PnL charts, and wallet profiles.
  </Card>

  <Card title="Terminals" icon="monitor" href="/use-cases/terminals">
    Full trading front ends: order entry, portfolio, and discovery in one surface.
  </Card>
</CardGroup>

## Start building

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="braces" href="/sdk/typescript">
    Type-safe client with built-in auth and pagination.
  </Card>

  <Card title="Python SDK" icon="code" href="/sdk/python">
    Pythonic wrapper for all three Bravado APIs.
  </Card>

  <Card title="Concepts" icon="layers" href="/products/trade-api">
    Understand order types, positions, analytics, and copy-trading.
  </Card>

  <Card title="Error Reference" icon="triangle-alert" href="/reference/errors">
    HTTP status codes, error shapes, and troubleshooting.
  </Card>
</CardGroup>