Developer API 开发者接口

云股池 API 专为机构客户、量化团队及高级游资设计，用于将我们的核心算法引擎算力与您的本地交易系统、风控面板无缝对接。所有接口均基于 RESTful 架构，返回 JSON 格式数据。

合规提示：我们的 API 仅提供策略引擎的“信号结果查询”与“推送服务”，绝对不包含任何直接对接券商账户的交易下单功能。

身份鉴权 (Authentication)

调用所有 API 接口，均需在 HTTP Header 中携带您的专属 X-API-Key 进行身份验证。未授权或过期的请求将被拒绝 (HTTP 401)。

// HTTP Header 示例
Authorization: Bearer <YOUR_API_KEY_HERE>
                

频率限制

为保障算力集群的稳定，我们对 API 调用进行了严格的频率限制：

PRO 订阅版用户：每秒限制 2 次请求 (2 req/s)
ENT 定制版用户：部署于独立私有服务器，无硬性频率限制，仅受服务器物理性能约束。

当触发限流时，接口将返回 HTTP 429 Too Many Requests。

获取引擎信号列表

拉取指定策略引擎在当日生成的候选股池及交易指令信号。

GET /api/v1/engine/{module_id}/signals

请求参数 (Query)

参数名	类型	必填	描述
`module_id`	`string`	是	策略引擎的唯一标识，如 `SB_WEAK2STRONG_V2`
`date`	`string`	否	查询日期，格式 `YYYY-MM-DD`。不传则默认拉取当日最新数据。

响应示例 (Response)

{
  "code": 200,
  "msg": "success",
  "data": {
    "engine_id": "SB_WEAK2STRONG_V2",
    "timestamp": "2024-03-08T09:30:05Z",
    "signals": [
      {
        "stock_code": "002XXX",
        "stock_name": "科技龙头",
        "action": "BUY_DIP",
        "trigger_price": 15.42,
        "stop_loss": 14.80,
        "confidence": 0.85
      }
    ]
  }
}
                

即时 Webhook 推送

对于盘中毫秒级短线引擎，主动轮询 (Polling) 效率极低。建议高级用户在后台配置 Webhook URL，当引擎计算出结果瞬间，我们会主动向您的服务器发送 POST 请求。

请确保您的接收端服务器能够在 2 秒内响应 HTTP 200。若连续 5 次超时，Webhook 投递将被暂时挂起。

推送载荷示例 (Payload)

// POST <YOUR_WEBHOOK_URL>
{
  "event": "signal.triggered",
  "module_id": "LB_EMOTION_RADAR",
  "payload": {
    "alert_type": "MARKET_PANIC",
    "message": "连板情绪极度衰竭，触发挥发性熔断指标",
    "action": "CLEAR_POSITION"
  }
}
                