SuperAPI AI 工具集

bingx-swap-account

数据与分析

查看项目

更新于 10-15 20:06

技能介绍

用途:查询 BingX 永续合约账户数据,包括余额与保证金、当前持仓与未实现盈亏、手续费率以及资金流水历史。所有接口均为只读 GET,不会修改账户状态。

主要能力:账户余额与权益(/openApi/swap/v3/user/balance);当前持仓、盈亏与强平价(/openApi/swap/v2/user/positions);用户 taker/maker 费率(/openApi/swap/v2/user/commissionRate);资金流水,含已实现盈亏、资金费、交易费、强平、ADL 等类型(/openApi/swap/v2/user/income);以及导出 Excel(/openApi/swap/v2/user/income/export)。

使用方式:需 API Key 与 Secret,所有认证接口须带 timestamp,可选 recvWindow(最大 60000)。签名使用 HMAC SHA256,参数按字典序拼接后附加 signature。请求头需包含 X-BX-APIKEY 与 X-SOURCE-KEY: BX-AI-SKILL。响应须用 json-bigint 解析,避免大整数精度丢失。主域名为 open-api.bingx.com,网络或超时错误时才回退到 .pro。

参数:symbol 格式为 BASE-QUOTE(如 BTC-USDT),须匹配 ^[A-Z0-9]+-[A-Z]+$;incomeType 为枚举值;startTime/endTime 为毫秒时间戳;limit 默认 100、最大 1000。

适用场景:查询账户余额、查看持仓与强平价、核对手续费、统计资金流水与资金费。

限制:仅支持只读查询;资金流水默认返回最近 7 天,仅可查最近 3 个月;参数值不得包含 &、=、?、# 或换行符;未提供账户时默认主账户。完整响应结构与更多细节见 api-reference.md 与 references/authentication.md。