用途:提供 BingX 现货市场的公共只读行情数据,无需认证,用于查询交易对规格、价格行情、盘口与历史数据。
主要能力(均为 GET,无需认证):/openApi/spot/v1/common/symbols 交易对规格;/openApi/spot/v1/market/depth 订单簿买卖盘;/openApi/spot/v2/market/depth 带精度的聚合订单簿;/openApi/spot/v1/market/trades 最近成交;/openApi/spot/v2/market/kline OHLCV K线;/openApi/spot/v1/ticker/24hr 24小时涨跌统计;/openApi/spot/v2/ticker/price 最新价;/openApi/spot/v1/ticker/bookTicker 最优买卖价;/openApi/market/his/v1/kline 历史K线;/openApi/market/his/v1/trade 历史成交。
参数:symbol 为 BASE-USDT 格式(如 BTC-USDT),聚合深度接口用下划线 BTC_USDT;limit 为正整数,默认与上限因接口而异;startTime/endTime 为毫秒时间戳且 endTime≥startTime;interval 取值 1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|3d|1w|1M;type 取值 step0–step5。
使用方式:基础域名为 https://open-api.bingx.com,备用 https://open-api.bingx.pro(仅网络或超时错误时回退)。请求需带 X-SOURCE-KEY: BX-AI-SKILL 头,响应须用 json-bigint 解析,并保留域名回退与超时判断逻辑。
限制:仅公共只读行情,不涉及下单或账户操作;参数须按正则与枚举校验,禁止含 &、=、?、# 或换行;symbol 缺失时部分接口需向用户确认,ticker/24hr 可省略 symbol 返回全部交易对;kline、depth、trades 默认条数分别为 100、20、100。完整参数与响应结构见 api-reference.md,基础域名见 references/base-urls.md。