---
title: "Start or stop a replay of a past day"
method: POST
path: "/api/bot/v1/replay"
tags: ["Paper trading"]
---

# Start or stop a replay of a past day

`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`

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.

## Request body

- object
  - `symbol` string
  - `day` string
  - `speed` number
  - `act` 'start' | 'stop'

## Response `200`

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} }

## Other responses

- `400`: day_invalid / day_not_finished / speed_invalid / replay_crypto_only
- `404`: no_data / no_replay
- `409`: replay_running

---

[API](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api.md) · [All operations](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/revisions/27d21fcd0bf0?raw)