创建策略

基于模板创建一个新策略。策略以 draft 状态创建，在调用 部署 之前不会开始交易。

端点

POST /v1/strategies

权重： 5 鉴权： 必填（需签名）—— 参见 鉴权。

请求

名称	类型	必填	说明
name	string	是	人类可读的名称，1–64 个字符。同一账户内必须唯一。
template_id	string	是	模板 slug，例如 tpl_grid、tpl_dca、tpl_momentum、tpl_meanrev。
params	object	是	模板特定参数。对平台不透明 —— 直接透传给模板运行时。会按模板的 schema 校验。
symbols	array<string>	是	一个或多个交易所风格的大写代码（例如 BTCUSDT），必须与交易所信息匹配。1–10 个。
timeframe	enum<1m|5m|15m|1h|4h|1d>	是	模板运行的 K 线周期。
capital	decimal	是	分配给策略的计价币种名义资金，使用十进制字符串表示。必须达到模板的最低要求（通常为 100.00）。
leverage	integer	否	杠杆倍数。默认 1，范围 1–20。

响应

{
  "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": "draft",
  "deployed_at": null,
  "created_at": "2026-04-29T12:00:00Z",
  "updated_at": "2026-04-29T12:00:00Z",
  "stats": {
    "open_positions": 0,
    "total_pnl": "0.00",
    "total_trades": 0,
    "win_rate": "0.000"
  }
}

响应字段

字段	类型	说明
id	string	策略标识符，格式为 strat_<6-8 位十六进制>。
name	string	提交时填写的名称。
template_id	string	模板 slug。
params	object	提交时的模板参数。
symbols	array	策略交易的交易对。
timeframe	string	K 线周期。
capital	string	计价币种名义资金，十进制字符串。
leverage	integer	当前生效的杠杆倍数。
status	enum	取值之一：draft、deployed、paused、stopped、error。新建策略为 draft。
deployed_at	string|null	最近一次部署的 ISO 8601 UTC 时间戳，未部署则为 null。
created_at	string	ISO 8601 UTC 创建时间。
updated_at	string	ISO 8601 UTC 最近修改时间。
stats	object	累计运行统计。draft 策略下为零。

错误

• 400 INVALID_PARAMETER —— 缺少必填字段、params 未通过模板校验、capital 低于最小值，或 leverage 超出范围。
• 404 NOT_FOUND —— template_id 不存在。
• 409 DUPLICATE_NAME —— 账户下已存在同名策略。

完整列表参见 错误。

示例

curl -X POST "https://api.pipai.example/v1/strategies" \
  -H "X-PipAI-API-Key: $API_KEY" \
  -H "X-PipAI-Timestamp: $TS" \
  -H "X-PipAI-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{
    "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
  }'