Bravado Trade API v2: Endpoints and Integration Guide

Authenticate with HMAC. Signature values in request examples are placeholders; compute a fresh signature over the exact method, path and body. See authentication and the runnable quickstart.

The Bravado Trade API v2 is the single integration point for building Polymarket trading applications on Polygon. It exposes order placement (including algorithmic order types such as TWAP, Iceberg, and Pegged), position lifecycle management (redeem, split, merge), account inspection, and partner user provisioning, all behind a consistent REST interface using Polygon-native pUSD collateral.

Base URL

https://partner-api.bravadotrade.com

All Trade API paths are prefixed with /v2/trade/.

Authentication

Sign every request with HMAC using the following headers:

X-BRAVADO-API-KEY: <public-key>
X-BRAVADO-TIMESTAMP: <timestamp-ms>
X-BRAVADO-SIGNATURE: <signature-for-this-request>

Mutating requests (POST, DELETE) additionally require an Idempotency-Key header containing a unique string (UUID recommended). Replaying the same key within the idempotency window returns the cached response without re-executing the operation.

All numeric fields in API responses are returned as JSON strings to preserve decimal precision. Parse them with an arbitrary-precision decimal library rather than native floats.

Endpoint Summary

Method	Path	Description
`POST`	`/v2/trade/order`	Place a single order (LIMIT / MARKET / PEGGED / TWAP / ICEBERG / STOP_LOSS / TAKE_PROFIT / TRAILING_STOP)
`POST`	`/v2/trade/order/batch`	Place up to 20 limit orders atomically (bid/ask ladder)
`GET`	`/v2/trade/orders/open`	List all open CLOB orders
`DELETE`	`/v2/trade/orders/{order_id}`	Cancel a single open order
`POST`	`/v2/trade/orders/cancel-batch`	Cancel up to 50 orders by ID
`POST`	`/v2/trade/orders/cancel-all`	Cancel every open order on the account
`GET`	`/v2/trade/positions`	List active or closed outcome token positions
`POST`	`/v2/trade/positions/redeem`	Redeem a resolved CTF position to pUSD
`POST`	`/v2/trade/positions/split`	Split pUSD into a complete outcome set
`POST`	`/v2/trade/positions/merge`	Merge a complete outcome set back to pUSD
`GET`	`/v2/trade/strategies`	List managed strategies (TWAP, Iceberg, Pegged, Stops)
`DELETE`	`/v2/trade/strategies/{id}`	Cancel a managed strategy by record ID
`GET`	`/v2/trade/account`	Account snapshot, partner, wallet, API key scopes
`GET`	`/v2/trade/balances`	Collateral balances (pUSD and USDC.e)
`GET`	`/v2/trade/balances/withdrawable`	All ERC20 balances available to withdraw
`POST`	`/v2/trade/withdraw`	Withdraw pUSD (or any ERC20) to an external Polygon address
`GET`	`/v2/trade/activity`	Trade activity timeline with pagination
`POST`	`/v2/trade/users`	Provision a partner-scoped user (white-label flow)

Sections

Explore the detailed reference for each area of the API:

Orders, place, query, and cancel individual or batched orders across all supported order types.
Positions, inspect open and closed positions and perform on-chain lifecycle actions (redeem, split, merge).
Strategies, monitor and cancel long-running managed strategies such as TWAP, Iceberg, Pegged, and stop orders.
Account, retrieve your account snapshot, collateral balances, and trade activity history.
Withdraw, move pUSD or other ERC20 tokens from your deposit wallet to any Polygon address.

Market Data

Trade API

Combos API

Copytrade API

Trader Data API

Bravado Trade API v2: Endpoints and Integration Guide

Base URL

Authentication

Endpoint Summary

Sections

​Base URL

​Authentication

​Endpoint Summary

​Sections

Base URL

Authentication

Endpoint Summary

Sections