用途:封装 BingX 钱包充值提现相关接口,供 AI 代理在用户授权下查询与操作现货钱包资金。
主要能力:查询充值历史(/openApi/api/v3/capital/deposit/hisrec)、查询提现历史(/openApi/api/v3/capital/withdraw/history)、查询币种充提配置含网络/限额/手续费(/openApi/wallets/v1/capital/config/getall)、发起提现(/openApi/wallets/v1/capital/withdraw/apply)、查询主账户充值地址(/openApi/wallets/v1/capital/deposit/address)、查询充值风控记录(/openApi/wallets/v1/capital/deposit/riskRecords)。除提现外均为只读接口。
使用方式:所有接口需 HMAC SHA256 签名,请求头需带 X-BX-APIKEY 与 X-SOURCE-KEY: BX-AI-SKILL。资料要求逐字复制 fetchSigned 函数,使用 json-bigint 解析响应,不得改写签名、请求或解析逻辑,不得移除域名回退循环与 isNetworkOrTimeout 判断。主域名为 open-api.bingx.com,.pro 仅作网络或超时错误时的回退。提现参数含 coin、network、address、addressTag、amount、walletType(1 资金账户、2 标准合约、3 永续合约)等。
适用场景:查询充提记录、核对币种网络与手续费、获取充值地址、在确认后发起提现。
限制:提现为写操作,生产环境(prod-live)需用户输入 CONFIRM;模拟环境(prod-vst)无需确认但需告知用户。参数需客户端校验,禁止含 &、=、?、# 或换行;coin 需匹配 ^[A-Z0-9]{1,20}$;时间范围最大 90 天;recvWindow 建议尽量小。资料未提供具体费率、限额数值与完整响应结构,需查阅 api-reference.md 与 references 目录。