用途:面向 BingX 资金账户的鉴权管理接口集合,所有端点均需 HMAC SHA256 签名认证,用于查询与划转资金账户资产。
主要能力:查询资金账户余额(GET /openApi/spot/v1/account/balance);查询跨所有账户类型的资产概览(GET /openApi/account/v1/allAccountBalance);账户间资产划转(POST /openApi/api/v3/asset/transfer);查询划转记录(GET /openApi/api/v3/asset/transfer);向其他 BingX 用户进行内部 P2P 转账(POST /openApi/wallets/v1/capital/innerTransfer/apply);查询内部转账历史(GET /openApi/wallets/v1/capital/innerTransfer/records)。
使用方式:使用 fetchSigned 封装函数完成签名和请求,需提供 apiKey 与 secretKey,域名 open-api.bingx.com 为主、.pro 为网络或超时错误时的回退;请求需携带 X-BX-APIKEY 与 X-SOURCE-KEY: BX-AI-SKILL 头,使用 json-bigint 解析响应。划转需传 type、asset、amount;内部转账需传 coin、userAccountType、userAccount、amount、walletType,手机号方式需 callingCode。参数需客户端校验:asset 匹配 ^[A-Z0-9]{1,20}$,amount 为正数,size 为 1 至 100,recvWindow 不超过 60000 毫秒。
适用场景:账户余额与资产总览查看、现货与合约账户间资金调拨、站内用户间转账及历史记录核对。
限制:需自备 API 密钥;生产实盘(prod-live)的 POST 划转与内部转账需用户输入 CONFIRM 确认,prod-vst 环境无需确认但须提示处于模拟环境;参数中禁止含 &、=、?、# 或换行符;具体响应字段与完整参数参见 api-reference.md。费率、限额等暂未提供。