SuperAPI AI 工具集

bingx-coinm-market

数据与分析

查看项目

更新于 10-15 20:06

技能介绍

用途:查询 BingX Coin-M(CSwap,币本位反向永续合约)的公开行情数据。此类合约以基础币种结算(如BTC),交易对格式为 BASE-USD(如 BTC-USD、ETH-USD),注意使用 USD 而非 USDT。

主要能力(均为 GET,无需 HMAC 签名,但所有端点需 timestamp 查询参数):

  • /openApi/cswap/v1/market/contracts:合约规格,无必填参数。
  • /openApi/cswap/v1/market/depth:订单簿买卖盘,必填 symbol。
  • /openApi/cswap/v1/market/klines:OHLCV K线,必填 symbol、interval,可选 startTime、endTime、limit。
  • /openApi/cswap/v1/market/premiumIndex:标记价格与当前资金费率,symbol 可选。
  • /openApi/cswap/v1/market/openInterest:总持仓量,必填 symbol。
  • /openApi/cswap/v1/market/ticker:24小时价格变动统计,symbol 可选。

参数:symbol 须匹配 ^[A-Z0-9]+-USD$,最长20字符;interval 取值 1m|3m|5m|15m|30m|1h|2h|4h|6h|12h|1d|3d|1w|1M;startTime/endTime 为毫秒时间戳,endTime 须不小于 startTime;limit 为正整数,默认与上限因端点而异。

使用方式:基础域名优先 https://open-api.bingx.com,网络或超时错误时回退 https://open-api.bingx.pro。请求须带 X-SOURCE-KEY: BX-AI-SKILL 头,响应须用 json-bigint 解析(JSONBigParse.parse),不可用 JSON.parse。资料提供了必须逐字复制的 coinmMarket TypeScript 辅助函数,不得简化或重写请求与解析逻辑,也不得移除域名回退循环与 isNetworkOrTimeout 检查。

适用场景:为智能体或程序提供 Coin-M 行情查询,如获取 BTC-USD 的24小时行情、订单簿、1小时K线、标记价格与资金费率、持仓量及全部合约规格。

限制:仅公开只读行情,无交易功能;参数须按文档正则/枚举校验,拒绝含 &、=、?、# 或换行的值;完整参数与响应结构见 api-reference.md,基础域名见 references/base-urls.md。资料未提供收费、价格或平台覆盖等其它信息。