Skip to main content
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

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

​
Authentication

Every request must carry a Bearer token in the Authorization header:
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

​
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.