Get Strategy

Retrieve a single strategy by ID, including its current params, status, and runtime stats.

Endpoint

GET /v1/strategies/{id}

Weight: 1 Authentication: Required (signed) — see Authentication.

Request

Path parameter: id — the strategy identifier (e.g. strat_8f2a1b).

No query parameters or body.

Response

{
  "id": "strat_8f2a1b",
  "name": "BTC grid 1h",
  "template_id": "tpl_grid",
  "params": {
    "grid_levels": 8,
    "upper_price": "72000",
    "lower_price": "60000",
    "rebalance_threshold": "0.02"
  },
  "symbols": ["BTCUSDT"],
  "timeframe": "1h",
  "capital": "10000.00",
  "leverage": 3,
  "status": "deployed",
  "deployed_at": "2026-04-29T08:00:00Z",
  "created_at": "2026-04-28T15:30:00Z",
  "updated_at": "2026-04-29T08:00:00Z",
  "stats": {
    "open_positions": 2,
    "total_pnl": "184.32",
    "total_trades": 47,
    "win_rate": "0.638"
  }
}

Response fields

Field	Type	Description
id	string	Strategy identifier, format strat_<6-8 hex>.
name	string	Human-readable label.
template_id	string	Template slug, e.g. tpl_grid.
params	object	Template-specific parameters. Schema depends on the template.
symbols	array<string>	Symbols the strategy trades.
timeframe	string	Candle interval, e.g. 1m, 1h, 1d.
capital	string	Quote-currency notional, decimal string.
leverage	integer	Leverage multiplier, 1–20.
status	enum	One of draft, deployed, paused, stopped, error.
deployed_at	string|null	ISO 8601 UTC timestamp of the most recent deploy, or null if never deployed.
created_at	string	ISO 8601 UTC creation time.
updated_at	string	ISO 8601 UTC last modification time.
stats	object	Cumulative runtime statistics.
stats.open_positions	integer	Number of currently open positions.
stats.total_pnl	string	Realized + unrealized PnL in quote currency, decimal string.
stats.total_trades	integer	Lifetime number of closed trades.
stats.win_rate	string	Fraction of winning trades, decimal string in [0, 1].

Errors

• 404 NOT_FOUND — strategy does not exist or is not owned by the caller.

See Errors for the full list.

Example

curl "https://api.pipai.example/v1/strategies/strat_8f2a1b" \
  -H "X-PipAI-API-Key: $API_KEY" \
  -H "X-PipAI-Timestamp: $TS" \
  -H "X-PipAI-Signature: $SIG"