Copytrade Simulation Portfolio API Reference

GET /v2/trade/copytrade/simulation and POST /simulation/reset: view and reset the paper trading portfolio for a copytrade subscription.

Simulation mode lets you test a copytrade strategy without risking real capital. When you create a subscription with is_simulation: true, every copied fill is recorded as a paper trade, positions are tracked, PnL is calculated using live CLOB midpoint prices, and execution history is preserved, all without placing real on-chain orders. Use these endpoints to inspect your paper portfolio and wipe it clean when you want to start a fresh backtest.

---

GET /v2/trade/copytrade/simulation

Returns the current simulation paper account for the authenticated user, including the paper cash balance, all open paper positions marked to live market prices, and realized PnL from closed paper positions.

Headers

Header	Required	Description
Authorization	Yes	Bearer <token>

Response

initial_balance_usdc · string

The starting paper USDC balance when the simulation began. Returned as a string.

cash_usdc · string

Remaining paper cash not deployed into open positions. Returned as a string.

realized_pnl · string

Total realized PnL from paper positions that have been closed or resolved. Returned as a string.

unrealized_pnl · string

Unrealized PnL across all open paper positions, marked to the live CLOB midpoint price. Returned as a string. May be null if midpoint data is momentarily unavailable.

equity_usdc · string

Total paper account equity: cash_usdc plus the current market value of all open positions. Returned as a string. May be null if any position’s midpoint is unavailable.

positions · object[]

Array of open paper positions.

Show positions fields

token_id · string

The Polymarket outcome token ID for this position.

shares · string

Number of paper shares held. Returned as a string.

avg_cost · string

Average cost per share in cents across all fills for this position. Returned as a string.

cost_basis · string

Total paper USD spent to acquire the current position (shares × avg_cost). Returned as a string.

mark_price · string | null

Current CLOB midpoint price in cents used to mark this position to market. null if the midpoint was momentarily unavailable when the snapshot was taken.

market_value · string | null

Current marked market value of the position in USD (shares × mark_price). null when mark_price is null.

unrealized_pnl · string | null

Unrealized gain or loss on this position (market_value − cost_basis). null when mark_price is null.

mark_price, market_value, and unrealized_pnl at the position level are null when the CLOB midpoint was momentarily unavailable at snapshot time. The top-level unrealized_pnl and equity_usdc fields are similarly null if any constituent position is missing a midpoint. Retry after a brief delay to get a fully priced snapshot.

Request

GET /v2/trade/copytrade/simulation
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

---

POST /v2/trade/copytrade//simulation/reset

Deletes all paper fill history for a specific copytrade subscription, resetting the paper portfolio to a clean slate. Use this when you want to re-test a strategy from scratch after changing the subscription config. Only paper (simulation) fills are affected, real fills are never touched by this operation.

Headers

Header	Required	Description
Authorization	Yes	Bearer <token>

Path parameters

Parameter	Type	Description
id	string	The copytrade subscription ID whose simulation history you want to clear

Request body

No request body is required.

Response

deleted_count · integer

The number of paper fill records that were deleted from the simulation history.

This operation only clears paper fills associated with the specified subscription ID. Real (non-simulation) fills, PnL records, and any other subscription data are never affected. The subscription itself remains active and continues to paper-trade after the reset.

Request

POST /v2/trade/copytrade/ct_01HX6N0QRST9XDYP5FZELOH8I/simulation/reset
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

After a reset, the paper balance returns to initial_balance_usdc and all open paper positions are cleared. If you also updated the subscription’s sizing config before resetting, the new parameters take effect immediately for all future paper fills.