List Strategies

List strategies owned by the authenticated user. Results are sorted by created_at in descending order (newest first).

Endpoint

GET /v1/strategies

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

Query parameters

Name	Type	Mandatory	Description
status	enum<draft|deployed|paused|stopped|error>	NO	Filter by lifecycle status.
template_id	string	NO	Filter by template, e.g. tpl_grid.
limit	integer	NO	Page size. Range 1–100. Default 20.
cursor	string	NO	Opaque pagination cursor returned by a previous call. See General Info.

Response

{
  "data": [
    {
      "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"
      }
    },
    {
      "id": "strat_3c91de",
      "name": "ETH DCA daily",
      "template_id": "tpl_dca",
      "params": {
        "interval": "1d",
        "buy_amount": "100"
      },
      "symbols": ["ETHUSDT"],
      "timeframe": "1d",
      "capital": "5000.00",
      "leverage": 1,
      "status": "paused",
      "deployed_at": "2026-04-15T00:00:00Z",
      "created_at": "2026-04-14T10:12:00Z",
      "updated_at": "2026-04-27T09:15:00Z",
      "stats": {
        "open_positions": 0,
        "total_pnl": "62.10",
        "total_trades": 12,
        "win_rate": "0.583"
      }
    }
  ],
  "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNC0xNFQxMDoxMjowMFoifQ"
}

Response fields

Field	Type	Description
data	array<object>	List of strategy objects. See Get Strategy for the per-object schema.
next_cursor	string|null	Pass to the next call to retrieve the following page. null when no further pages remain.

Errors

• 400 INVALID_PARAMETER — limit out of range, cursor malformed, or status/template_id value invalid.

See Errors for the full list.

Example

curl -G "https://api.pipai.example/v1/strategies" \
  --data-urlencode "status=deployed" \
  --data-urlencode "limit=50" \
  -H "X-PipAI-API-Key: $API_KEY" \
  -H "X-PipAI-Timestamp: $TS" \
  -H "X-PipAI-Signature: $SIG"