通用信息

Base URL

https://api.pipai.org

该域名上同时提供两类路由：/fapi/v1/* 是 Binance 透明镜像（nginx 直接转发到 fapi.binance.com），其余路径走 FastAPI 网关。具体每个端点走哪一类，见 行情模块概览。

请求与响应格式

• 请求与响应均为 JSON。
• 时间戳同时存在两种约定：
  • 平台自有资源（例如 strategies）使用 ISO 8601 UTC 字符串，如 2026-04-29T12:00:00。
  • 行情透传接口 保留 Binance 的 Unix 毫秒整数。
• 行情透传接口返回的价格、数量为字符串（沿袭 Binance 的约定）。
• 路径参数与查询参数大小写以后端声明为准。多数行情查询参数采用 camelCase（startTime、endTime）；少数旧接口使用 snake_case（start_time、end_time），相应页面会单独说明。

限流

• 按 IP，60 秒滑动窗口，每分钟最多 1000 次请求。
• 超限返回 HTTP 429，响应体 {"detail": "请求过于频繁。每个 IP 每分钟最多允许 1000 次请求。"}，并触发该 IP 一小时封锁。
• 封锁期间继续访问会得到 HTTP 429 {"detail": "IP <ip> 已被暂时封锁。请求过于频繁，请稍后再试。"}。
• / 与 /health 不计入限流。

健康检查

GET /health

返回 {"status": "healthy", "timestamp": "<ISO 8601>"}。无鉴权，不限流。