用途:通过 Binance 官方 API 访问 USDⓈ-M 期货(fapi)相关功能,涵盖行情数据、账户与持仓查询、交易下单、资金划转历史等,返回 JSON 格式结果。
主要能力:
- 行情与公共数据:ping、服务器时间、exchangeInfo、24hr ticker、价格/簿 ticker、Kline、aggTrades、historicalTrades、depth、openInterest、fundingRate、premiumIndex、indexPriceKlines、markPriceKlines 等。
- 账户与持仓(需认证):account v2/v3、balance v2/v3、positionRisk v2/v3、income、leverageBracket、commissionRate、symbolConfig、adlQuantile、pmAccountInfo、apiTradingStatus 等。
- 交易(TRADE):下单、批量下单、查询、撤销、批量撤销、修改订单、改变杠杆与保证金模式、持仓模式、多资产模式、BNB 抵扣、算法单(algoOrder)、countdownCancelAll、positionMargin 调整、test order。
- 数据下载:订单/成交/交易历史的异步下载 ID 与下载链接。
- 用户数据流:listenKey 的创建、keepalive 与关闭。
- Convert 功能:查询可兑换对、发送报价请求、接受报价、查询订单状态。
使用方式:需提供 API 凭证用于认证接口。apiKey 放在请求头(X-MBX-APIKEY),secretKey 用于签名。凭证可来自环境变量(主网 BINANCE_API_KEY / BINANCE_SECRET_KEY;测试网 BINANCE_TESTNET_API_KEY / BINANCE_TESTNET_SECRET_KEY)或密钥文件(如 ~/.openclaw/secrets.env、~/.env),建议单次执行内读取使用,避免密钥进入上下文。
基础地址:
- 主网:https://fapi.binance.com
- 测试网:https://demo-fapi.binance.com
限制与注意:部分接口需认证;下单等交易接口有参数约束与枚举限制(如 side、positionSide、timeInForce、contractType 等);批量订单与批量撤单数量有限制(如 batchOrders 最多 5 单,orderIdList 最多 10);时间戳参数为毫秒;goodTillDate 仅保留秒级精度且须大于当前时间加 600 秒。具体费率、限额与行为以 Binance 官方文档为准,资料未提供的信息暂未提供。