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
Response
string
The starting paper USDC balance when the simulation began. Returned as a string.
string
Remaining paper cash not deployed into open positions. Returned as a string.
string
Total realized PnL from paper positions that have been closed or resolved. Returned as a string.
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.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.object[]
Array of open paper positions.
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.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
Path parameters
Request body
No request body is required.Response
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.