Paper trading

Start or stop a replay of a past day

Start: {symbol, day:"YYYY-MM-DD" (a complete past UTC day), speed (1-600 market seconds per real second, default 60)}. From then on the key’s trading calls act on a separate replay journal priced from MarginPad’s own 1-minute candles; stops, targets and liquidations are checked on every candle between two calls. Stop: {act:"stop"} closes everything at the cursor, returns the summary and empties the replay journal. One replay per key at a time; crypto only; limit and stop entries are not available in replay.

post/api/bot/v1/replay

Request

Base URL: https://marginpad.io
URL: https://marginpad.io/api/bot/v1/replay
Auth: API key in header X-API-Key

Request body

symbolstring

daystring

speednumber

act'start' | 'stop'

Example request

{
  "symbol": "BTC",
  "day": "2026-09-11",
  "speed": 60
}

Response

start: { ok, replay:{id, symbol, day, speed, start_ts, end_ts, candles, first_price} } · stop: { ok, replay:{closes, wins, losses, win_rate_pct, pnl_usd, return_pct, liquidations, trades} }

Changes

No recorded changes to this operation across all 1 revision of this API.