---
title: "Simulate Coin"
method: POST
path: "/simulate/coin"
---

# Simulate Coin

`POST /simulate/coin`

## Request

- Base URL: `https://api.pruviq.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pruviq.com/simulate/coin`
- Auth: none declared

Offload the single-coin backtest to a worker thread (event-loop safe).

## Request body

- CoinSimRequest
  - `symbol` string, required
  - `fee_pct` number, nullable: Fee per side (0.0005 = 0.05%). None = use market_type default
  - `sl_pct` number
  - `tp_pct` number
  - `max_bars` integer
  - `direction` string
  - `market_type` 'futures' | 'spot'
  - `start_date` string, nullable: Backtest start date (YYYY-MM-DD)
  - `end_date` string, nullable: Backtest end date (YYYY-MM-DD)
  - `timeframe` '1H' | '2H' | '4H' | '6H' | '12H' | '1D' | '1W': Candle timeframe: 1H, 2H, 4H, 6H, 12H, 1D, 1W
  - `strategy` string, nullable: Strategy id (registry). Omitted = legacy bb-squeeze-{direction}.
  - `leverage` number

## Response `200`

Successful Response

- CoinSimResponse
  - `symbol` string, required
  - `total_trades` integer, required
  - `win_rate` number, required
  - `profit_factor` number, required
  - `total_return_pct` number, required
  - `max_drawdown_pct` number, required
  - `tp_count` integer, required
  - `sl_count` integer, required
  - `timeout_count` integer, required
  - `sharpe_ratio` number
  - `sortino_ratio` number
  - `calmar_ratio` number
  - `trades` TradeDetail[], required
    - `direction` 'long' | 'short', required
    - `entry_time` integer, required
    - `entry_price` number, required
    - `exit_time` integer, required
    - `exit_price` number, required
    - `pnl_pct` number, required
    - `exit_reason` string, required
    - `bars_held` integer, required
    - `mfe_pct` number
    - `mae_pct` number

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pruviq/apis/pruviq-simulation-api.md) · [All operations](https://skmtc.dev/pruviq/apis/pruviq-simulation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pruviq/apis/pruviq-simulation-api/revisions/972384919a74?raw)