用途:该技能用于查询 BingX 标准合约(standard futures)账户数据,所有接口均为只读 GET 请求,不会修改账户状态。
主要能力:提供三个认证接口。GET /openApi/contract/v1/allPosition 查询当前全部持仓,返回交易对、保证金、杠杆、未实现盈亏、逐仓标记、开仓均价、方向(LONG/SHORT)、持仓数量、当前价与开仓时间。GET /openApi/contract/v1/allOrders 查询某交易对历史订单,必填 symbol,可选 orderId、startTime、endTime、limit、recvWindow,返回订单号、状态、成交均价、成交额、成交量、保证金、杠杆、平仓价、仓位 ID 与时间。GET /openApi/contract/v1/balance 查询标准合约余额,返回资产、总余额、全仓钱包余额、全仓未实现盈亏、可用余额、最大可转出额、是否可作保证金与更新时间。
使用方式:所有接口需 HMAC SHA256 签名认证,公共参数含 timestamp 与 recvWindow。资料要求生成代码时逐字复制 fetchSigned 函数,使用 json-bigint 解析响应,并在每个请求携带 X-SOURCE-KEY: BX-AI-SKILL 头。域名以 .com 为主,.pro 仅作网络或超时错误回退。参数需按规则校验,symbol 须匹配 ^[A-Z0-9]+-[A-Z]+$ 且不超过 20 字符,orderId 为正整数,endTime 不小于 startTime,recvWindow 为 1–5000 毫秒。
适用场景:用户询问标准合约持仓、未实现盈亏、历史订单或账户余额时调用。若意图不明确,可列出持仓、历史订单、余额三类选项供选择。
限制:仅覆盖标准合约的查询,不涉及下单或修改账户;需提供 API 凭证,未指定账户时默认主账户;参数不得包含 &、=、?、# 或换行符;完整参数与响应结构见 api-reference.md,基础 URL 与认证细节见对应参考文件。