Copytrade API Overview: Mirror Trader Fills on Bravado

Subscribe to a leader wallet so trades are automatically mirrored on Bravado with configurable sizing, order filters, and risk controls.

The Copytrade API lets you automatically mirror the on-chain trading activity of any Polygon wallet. When the leader executes a fill on Polymarket, Bravado detects it and immediately places a corresponding order on behalf of the subscribed follower, using the sizing mode, filters, and risk controls you configure at subscription time. You can run multiple simultaneous subscriptions, pause and resume copying at any time, and test strategies risk-free using simulation mode before committing real capital.

Endpoints

Method	Path	Description
POST	/v2/trade/copytrade	Subscribe to a leader
GET	/v2/trade/copytrade	List active/paused subscriptions
PATCH	/v2/trade/copytrade/{id}	Update subscription config
DELETE	/v2/trade/copytrade/{id}	Cancel (soft-delete) subscription
PATCH	/v2/trade/copytrade/{id}/status	Pause, resume, or disable a subscription
GET	/v2/trade/copytrade/history	Copied-trade execution history
GET	/v2/trade/copytrade/pnl	Realized PnL, 24h and lifetime
GET	/v2/trade/copytrade/simulation	Simulation paper portfolio
POST	/v2/trade/copytrade/{id}/simulation/reset	Reset paper fills for a subscription

Subscription lifecycle

A subscription moves through three states. Use PATCH /{id}/status to transition between them.

Status	Description
ACTIVE	Bravado is actively monitoring the leader and copying qualifying fills
PAUSED	Monitoring is suspended; no new fills are copied, but the subscription is preserved
DISABLED	Permanently deactivated; re-enable by patching status back to ACTIVE

DELETE /{id} performs a soft delete, the subscription is deactivated and excluded from the active list, but all historical fills and PnL data are preserved. If you attempt to create a new ACTIVE subscription for a leader that already has one, the API returns 409 CONFLICT.

Buy-side sizing modes

The buy_size_mode field controls how the follower order size is calculated whenever the leader places a buy.

Mode	Description
PCT_OF_LEADER_TRADE	Size the follower buy as a percentage of the leader’s notional
FIXED_USD_PER_TRADE	Spend a fixed USD amount on every copied buy
PCT_OF_FOLLOWER_AVAILABLE	Spend a percentage of the follower’s currently available pUSD balance

Sell-side sizing modes

The sell_size_mode field controls how the follower order size is calculated whenever the leader sells shares.

Mode	Description
PCT_OF_LEADER_TRADE	Mirror as a percentage of the leader’s share sale notional
FIXED_USD_PER_TRADE	Sell a fixed USD equivalent of shares
PCT_OF_FOLLOWER_AVAILABLE	Sell a percentage of the follower’s available pUSD balance
MAX	Sell the follower’s entire share position in that market
PCT_OF_MAX	Sell a percentage of the follower’s total share position

Use MAX or PCT_OF_MAX for sell-side sizing when you want the follower to fully exit a position whenever the leader sells, regardless of the leader’s actual sale size.

Risk controls

In addition to sizing, subscriptions support several risk control fields that you can set at creation or update later:

• take_profit_levels, Automatically sell a portion of the position when unrealized gain reaches a specified threshold (in basis points).
• stop_loss_levels, Automatically sell a portion of the position when unrealized loss reaches a specified threshold.
• close_at_price_cents, Trigger a full position close when the market price hits a target in cents (1–9999).
• max_hold_seconds, Force-close the position after a maximum number of seconds regardless of price.
• copy_start_date / copy_end_date, Restrict copying to a specific date range; outside this window, leader fills are ignored.

All numeric fields in API responses are returned as JSON strings. Parse them before performing arithmetic.