资金费率

资金费率数据，通过四个相关端点暴露。/fapi/v1/fundingRate 是 nginx 透明镜像 Binance（直接转发到 fapi.binance.com）；/funding/rates* 系列由平台 FastAPI 网关提供，每个端点的形态略有不同。

GET /fapi/v1/fundingRate —— 资金费率历史（Binance 镜像）

透传 Binance USDⓈ-M 永续合约 /fapi/v1/fundingRate。鉴权：公开。

查询参数

参数	类型	必填	默认值	说明
symbol	string	否	—	省略时返回所有交易对的数据。
limit	integer	否	Binance default 500	Binance 最大 1000。
startTime	integer	否	—	Unix 毫秒。
endTime	integer	否	—	Unix 毫秒。

响应 — 200 OK

数组（Binance 结构）：

[
  {
    "symbol": "BTCUSDT",
    "fundingTime": 1745928000000,
    "fundingRate": "0.00010000",
    "markPrice": "67890.12"
  }
]

示例

curl -s "https://api.pipai.org/fapi/v1/fundingRate?symbol=BTCUSDT&limit=10"

---

GET /funding/rates —— 所有交易对的当前资金费率

鉴权：公开。无查询参数。

响应 — 200 OK

返回值与平台 Binance 客户端 get_funding_rates() 的返回一致。通常是当前周期内的 {symbol, fundingRate, ...} 数组。

示例

curl -s "https://api.pipai.org/funding/rates"

---

GET /funding/rates/{symbol} —— 单个交易对的当前资金费率

鉴权：公开。

路径参数

参数	类型	必填	说明
symbol	string	是	大写永续合约符号。

响应 — 200 OK

该交易对的单个对象。

示例

curl -s "https://api.pipai.org/funding/rates/BTCUSDT"

---

GET /funding/rates/{symbol}/history —— 单个交易对的历史资金费率

鉴权：公开。

路径参数

参数	类型	必填	说明
symbol	string	是	大写永续合约符号。

查询参数

参数	类型	必填	默认值	说明
start_time	integer	否	—	snake_case。Unix 毫秒。
end_time	integer	否	—	snake_case。Unix 毫秒。
limit	integer	否	100

响应 — 200 OK

该交易对的历史资金费率数组。

错误（四个端点共用）

HTTP	触发原因
502	上游 Binance 请求失败。

示例

curl -s "https://api.pipai.org/funding/rates/BTCUSDT/history?limit=50"