用途:帮助用户在 BingX 永续合约上以限价单(maker)方式入场,支持分批建仓、冰山式挂单和省手续费的执行,也用于把交易计划转为挂单参数。
主要能力:查询订单簿深度;按多个价位拆分下单;监控未成交单并按价格变化动态调整;超时自动撤销剩余挂单;输出订单计划与成交汇总。
必要用法:先解析用户意图,提取交易对、方向、金额、杠杆、层数(默认3)、价差、超时(默认300秒);缺少交易对、方向或金额时必须向用户确认。随后展示交易对、方向、金额、杠杆、层数、价格区间、超时与预计省费,经用户明确确认后执行。查询订单簿为只读,无需确认;下单需要确认。正式环境需用户输入 CONFIRM,模拟环境无需。
所用接口:GET /openApi/swap/v2/quote/depth 查询深度;POST /openApi/swap/v2/trade/order 下限价单;DELETE /openApi/swap/v2/trade/order 撤单。计划脚本示例:python3 scripts/maker.py --mode plan --symbol {symbol} --direction {direction} --amount {amount} --levels {levels} --orderbook '{orderbook_json}'。调用需签名(HMAC-SHA256、timestamp、X-BX-APIKEY 头),并携带 X-SOURCE-KEY: BX-AI-SKILL。
适用场景:希望避免吃单、降低手续费、分批建立多空仓位,或将 bingx-trading-plan 给出的入场区间转为挂单执行。
限制:费用数值、环境地址与认证细节在资料中未完整提供,需参考对应文档;存在余额不足、下单失败、订单簿价差过宽、撤单失败等错误处理路径,资料未给出具体费用与价格数值。