支持的行情品种

引擎支持 13 个 venue,包含黄金现货。一律通过同一组接口(/api/markets /api/klines /api/indicators 等)访问,canonical symbol 全大写、无分隔符。实际启用的 venue 与品种清单以 /api/markets 为准。

总览

资产类别	venue	品种数	支持的周期
加密	`binance:spot`	70	`1m` `5m` `15m` `1h` `4h` `1d`
加密 / 股票等永续合约	`binance:perp`	以发现接口为准	`1m` `5m` `15m` `1h` `4h` `1d`
	`bybit:spot`	70	`1m` `5m` `15m` `1h` `4h` `1d`
	`bybit:perp`	70	`1m` `5m` `15m` `1h` `4h` `1d`
	`okx:spot`	70	`1m` `5m` `15m` `1h` `4h` `1d`
	`okx:perp`	50	`1m` `5m` `15m` `1h` `4h` `1d`
	`hyperliquid:perp`	以发现接口为准	`1m` `5m` `15m` `1h` `4h` `1d`
A 股	`stock:cn`	32	`1m` `5m` `15m` `30m` `1h` `1d`
港股	`stock:hk`	20	`1h` `1d`
美股	`stock:us`	37	`1h` `1d`
外汇	`forex:spot`	10	`1h` `1d`
商品期货	`commodity:futures`	7	`1h` `1d`
黄金现货	`commodity:spot`	1	`5m` `15m` `30m` `1h` `4h` `1d`

实时查询最新列表

品种清单会不定期调整(新增热门标的、剔除低流动性的)。对接前先调发现端点拿最新结果:

bash

curl -H "Authorization: Bearer mq_xxx" https://api.mobiusquant.ai/api/markets
curl -H "Authorization: Bearer mq_xxx" \
     https://api.mobiusquant.ai/api/markets/binance/perp/symbols

指定时间的历史查询

已订阅的 Binance、Bybit、OKX 和 Hyperliquid 行情，包括币安股票永续，可直接通过 GET /api/klines、POST /api/indicators 或 POST /api/chart 查询指定时间。提供 startTime 或 endTime 后，接口自动读取可获取的历史，无需新参数，也无需先查 K 线再查指标。未传时间范围时保持最新行情查询。股票现货、外汇、商品期货和黄金现货仍遵守各自历史限制。

下面请求体可用于 /api/indicators 或 /api/chart，以标的已订阅且历史存在为前提：

json

{
  "exchange": "binance", "market": "perp", "symbol": "SNDKUSDT", "interval": "5m",
  "startTime": 1791849600000, "endTime": 1791936000000, "limit": 300,
  "signals": true,
  "calc": [{"name": "cvd", "id": "cvd"}, {"name": "hmm_regime", "id": "hmm"}]
}

两端是 K 线开盘时间的毫秒时间戳，包含边界。范围过大时取结束端最近 limit 个周期位置，缺口不补造，实际根数可更少。
仅传 endTime 查询该时间及之前的窗口；仅传 startTime 查询截至当前的最近窗口，不是从该时间向后分页。复盘建议同时传两端。
指标预热不占可见 limit。各端点原有输出上限不变；跨接口比较时使用共同允许的相同 limit。过大的指标参数和输出数量组合超过 6,000 根历史输入上限时返回400。
GET 的旧 extend_history 参数可保留，带时间范围时无需开启。不要向两个 POST 接口添加该字段，额外字段返回422。
固定已收盘窗口下，图表与数值使用一致的计算历史；特征和对象来自同次计算。可通过 include:["calculation"] 查看实际输入范围。行情修订或未收盘柱更新仍可能使不同请求的结果变化。
历史不足保留 null 和原有状态。不会用最新行情或股票现货替换目标历史，也不能还原历史盘中曾出现、后来消失的特征。

错误正文继续使用 {"detail":"..."}，可通过响应头 X-Kline-Error-Code 区分：

HTTP	标识	处理
404	`symbol_not_subscribed`	先核对订阅清单
404	`history_not_available`	所选窗口没有可返回行情，提示历史不可用
503	`history_preparing`	按 `Retry-After` 重试相同窗口
503	`history_busy`	按 `Retry-After` 退避，减少同时请求的窗口
503	`history_upstream_unavailable`	数据来源暂不可用，按 `Retry-After` 重试

其他服务503和API429继续按既有错误及 Retry-After 处理。数据来源限流也可能表现为历史来源暂不可用的503。无历史不等于标的退市；不要把失败请求改成最新数据查询。

交易所品种

`binance:spot`(70)

USDCUSDT, BTCUSDT, ETHUSDT, SOLUSDT, TONUSDT, ZECUSDT, BNBUSDT, XRPUSDT, DOGEUSDT, USD1USDT, TAOUSDT, NEARUSDT, SUIUSDT, DASHUSDT, DOGSUSDT, PEPEUSDT, LINKUSDT, FILUSDT, ADAUSDT, LUNCUSDT, FDUSDUSDT, IOUSDT, ICPUSDT, VANAUSDT, PAXGUSDT, ENAUSDT, TRXUSDT, CHIPUSDT, RLUSDUSDT, AVAXUSDT, PENGUUSDT, VIRTUALUSDT, XUSDUSDT, APTUSDT, DUSDT, UNIUSDT, ARUSDT, AAVEUSDT, ONDOUSDT, EURUSDT, FETUSDT, LTCUSDT, JTOUSDT, XAUTUSDT, OPUSDT, ASTERUSDT, WLDUSDT, NOTUSDT, ORDIUSDT, XPLUSDT, BTCUSDC, ETHUSDC, SOLUSDC, USD1USDC, ZECUSDC, XRPUSDC, EURUSDC, FDUSDUSDC, TONUSDC, TAOUSDC, SUIUSDC, BNBUSDC, LINKUSDC, DOGEUSDC, NEARUSDC, ICPUSDC, PENGUUSDC, ADAUSDC, PEPEUSDC, DOGSUSDC

`binance:perp`

以下为标的示例，实际订阅以发现接口为准。股票永续用法见币安股票永续。

ETHUSDT, BTCUSDT, SOLUSDT, LABUSDT, CLUSDT, ZECUSDT, XAUUSDT, TONUSDT, XAGUSDT, BZUSDT, DOGEUSDT, XRPUSDT, BNBUSDT, DOGSUSDT, HYPEUSDT, SKYAIUSDT, FILUSDT, NEARUSDT, 1000PEPEUSDT, TAOUSDT, IOUSDT, SUIUSDT, DASHUSDT, ADAUSDT, PLAYUSDT, ENAUSDT, FHEUSDT, LINKUSDT, ICPUSDT, PUMPUSDT, 1000LUNCUSDT, WIFUSDT, AVAXUSDT, VIRTUALUSDT, PAXGUSDT, BUSDT, ONDOUSDT, SOONUSDT, CRCLUSDT, JTOUSDT, PENGUUSDT, SNDKUSDT, AAVEUSDT, FARTCOINUSDT, VVVUSDT, OPUSDT, DUSDT, WLDUSDT, ZEREBROUSDT, NOTUSDT, ETHUSDC, BTCUSDC, SOLUSDC, ORDIUSDC, XRPUSDC, ZECUSDC, DOGEUSDC, 1000PEPEUSDC, BNBUSDC, FILUSDC, SUIUSDC, ENAUSDC, NEARUSDC, AVAXUSDC, ADAUSDC, LINKUSDC, LTCUSDC, BCHUSDC, PENGUUSDC, BIOUSDC

`bybit:spot`(70)

BTCUSDT, ETHUSDT, USDCUSDT, TONUSDT, ATHUSDT, BILLUSDT, SOLUSDT, XRPUSDT, HYPEUSDT, BLENDUSDT, ASTERUSDT, B3USDT, USDEUSDT, AAVEUSDT, MONUSDT, DOGEUSDT, MNTUSDT, XAUTUSDT, RENDERUSDT, ADAUSDT, NEARUSDT, EDGEUSDT, SUIUSDT, XPLUSDT, WIFUSDT, BNBUSDT, ICPUSDT, VVVUSDT, MEGAUSDT, VIRTUALUSDT, BSBUSDT, OPUSDT, ONDOUSDT, PEPEUSDT, FHEUSDT, ENAUSDT, PENGUUSDT, IPUSDT, AVAXUSDT, IOUSDT, PUMPUSDT, LINKUSDT, OPGUSDT, LUNCUSDT, LTCUSDT, ZEREBROUSDT, STETHUSDT, GALAUSDT, DOTUSDT, NOTUSDT, BTCUSDC, ETHUSDC, ARBUSDC, XRPUSDC, OPUSDC, SOLUSDC, BBSOLUSDC, DOGEUSDC, SUIUSDC, TONUSDC, MNTUSDC, ADAUSDC, APTUSDC, TRXUSDC, ZROUSDC, USDEUSDC, AVAXUSDC, LTCUSDC, BNBUSDC, ONDOUSDC

`bybit:perp`(70)

BTCUSDT, ETHUSDT, SOLUSDT, TONUSDT, LABUSDT, XRPUSDT, DOGEUSDT, ZECUSDT, HYPEUSDT, 1000PEPEUSDT, B3USDT, NEARUSDT, TAOUSDT, SUIUSDT, FARTCOINUSDT, BILLUSDT, ADAUSDT, ICPUSDT, ENAUSDT, CLUSDT, XAUTUSDT, ONDOUSDT, WIFUSDT, VIRTUALUSDT, NOTUSDT, LINKUSDT, DASHUSDT, IOUSDT, BNBUSDT, AAVEUSDT, JTOUSDT, FHEUSDT, PENGUUSDT, OPUSDT, FILUSDT, XAUUSDT, VVVUSDT, ARBUSDT, BIOUSDT, XPLUSDT, AVAXUSDT, XMRUSDT, PUMPFUNUSDT, BSBUSDT, GALAUSDT, DOTUSDT, APTUSDT, WLDUSDT, 1000LUNCUSDT, ZEREBROUSDT, ETHUSDC, BTCUSDC, SOLUSDC, TONUSDC, XRPUSDC, DOGEUSDC, NOTUSDC, MNTUSDC, WIFUSDC, HYPEUSDC, XAUTUSDC, XMRUSDC, ONDOUSDC, ENAUSDC, LINKUSDC, ORDIUSDC, BNBUSDC, DOTUSDC, WLDUSDC, XLMUSDC

`okx:spot`(70)

BTCUSDT, ETHUSDT, GRASSUSDT, SOLUSDT, TONUSDT, DOGEUSDT, USDCUSDT, XRPUSDT, MEGAUSDT, ZECUSDT, FILUSDT, XAUTUSDT, HYPEUSDT, SUIUSDT, BNBUSDT, TRXUSDT, USDGUSDT, PEPEUSDT, TRUMPUSDT, DOGSUSDT, OKBUSDT, RLUSDUSDT, ADAUSDT, LINKUSDT, ORDIUSDT, PIUSDT, LTCUSDT, NEARUSDT, PAXGUSDT, PENGUUSDT, ICPUSDT, DASHUSDT, IPUSDT, XPLUSDT, BIOUSDT, PUMPUSDT, ONDOUSDT, UNIUSDT, NOTUSDT, AAVEUSDT, JTOUSDT, WIFUSDT, AVAXUSDT, WLDUSDT, VIRTUALUSDT, BASEDUSDT, OFCUSDT, WLFIUSDT, ENAUSDT, CHZUSDT, BTCUSDC, ETHUSDC, SOLUSDC, LINKUSDC, XRPUSDC, DOGEUSDC, ZECUSDC, DOTUSDC, ADAUSDC, HYPEUSDC, VIRTUALUSDC, AVAXUSDC, DASHUSDC, EDGEUSDC, AAVEUSDC, ENJUSDC, COMPUSDC, KSMUSDC, SUIUSDC, CFGUSDC

`okx:perp`(50)

SATSUSDT, PEPEUSDT, SHIBUSDT, BONKUSDT, HMSTRUSDT, NOTUSDT, FLOKIUSDT, NEIROUSDT, PUMPUSDT, BOMEUSDT, GALAUSDT, DOGEUSDT, PENGUUSDT, MEMEUSDT, TURBOUSDT, BILLUSDT, AIUSDT, MEWUSDT, ZILUSDT, LINEAUSDT, RLSUSDT, SPACEUSDT, BIOUSDT, KATUSDT, RSRUSDT, PEOPLEUSDT, MONUSDT, ATHUSDT, CHZUSDT, PIPPINUSDT, XPLUSDT, OFCUSDT, UBUSDT, WLFIUSDT, ZKUSDT, BABYUSDT, LABUSDT, TONUSDT, ANIMEUSDT, CHIPUSDT, BASEDUSDT, OPUSDT, ADAUSDT, ENAUSDT, FOGOUSDT, ROBOUSDT, SAHARAUSDT, RAVEUSDT, STRKUSDT, WIFUSDT

币安股票永续

使用 exchange="binance"、market="perp" 和完整合约代码，例如 TSLAUSDT。不是 stock:us 股票现货；不要传裸代码 TSLA 或 market="stock"。本项只覆盖币安，不表示其他交易所支持股票合约。

先发现，再查询。 /api/markets/binance/perp/symbols 只返回本服务已订阅标的；上游已上市不表示本服务已订阅。该接口默认响应不变，增加 include_meta=true 可读取逐标的分类：

bash

curl 'https://api.mobiusquant.ai/api/markets/binance/perp/symbols?include_meta=true'

已订阅 TSLA 时的响应示例（仅展示一个标的）：

json

{
  "exchange": "binance",
  "market": "perp",
  "symbols": ["TSLAUSDT"],
  "count": 1,
  "symbol_meta": {
    "TSLAUSDT": {"instrument_type": "equity_perpetual", "underlying_symbol": "TSLA", "quote_asset": "USDT", "status": "trading"}
  },
  "metadata_status": "ready",
  "metadata_updated_at_ms": 1791936000000
}

字段	含义
`symbol_meta[代码].instrument_type`	股票永续为 `equity_perpetual`。其他可能值：`crypto_perpetual`、`commodity_perpetual`、`forex_perpetual`、`pre_ipo_perpetual`、`unclassified_tradfi_perpetual`、`unknown`。不能将未核验权益类合约或 ETF 当作已核验股票
`underlying_symbol`	已核验股票代码，如 `TSLA`；其他类型或未知时为 `null`
`quote_asset`	报价资产，已支持股票合约为 `USDT`；未知时为 `null`
`status`	`trading` 交易中、`pending` 待上市、`paused` 暂停、`ended` 已结束、`unknown` 未知
`metadata_status`	`ready` 目录可用、`stale` 目录过期或刷新失败、`unavailable` 尚无可用目录。不是 K 线就绪状态；过期信息不能作为当前可交易保证
`metadata_updated_at_ms`	目录最近成功更新时间，毫秒；未知时为 `null`

include_meta=true 目前仅支持 binance:perp，用于其他 venue 返回 400。元信息只对应已订阅标的，不增加 K 线、指标的数值列。venue 的 asset_class=crypto 是既有市场级标签，不能据此认定所有标的都是加密资产；用 instrument_type 区分具体合约。

周期：1m / 5m / 15m / 1h / 4h / 1d。实际启用周期和单次上限查询 /api/intervals?exchange=binance&market=perp。
OHLC 为合约成交价，volume/quote_volume 为上游合约成交量/成交额，不是股票现货成交量；不使用指数价或标记价，不复权、不拼接股票现货历史。
不按股票现货休市日历停更；周末或现货闭市不等于永续合约停止交易。交易暂停与数据过期需要分别判断。
startTime/endTime 仍为 K 线开盘时间范围（毫秒），三个行情接口均自动读取可获取的历史，见历史查询。不会生成上市前数据、补造缺失 K 线或提高单次返回上限。
已订阅后复用 /api/klines、/api/indicators、/api/chart。未订阅返回 404，数据准备中返回 503，按 Retry-After 重试。
指标和原生特征遵守各自历史、周期及连续性要求。CVD 是 OHLCV 估算，不是逐笔主动成交量；HMM 支持上述周期中的 5m / 15m / 1h / 4h / 1d，不支持 1m。新上市合约可能历史不足，不应将 null 当作没有特征。
使用 signals:true 获取特征，按需加 include_forming:true 试算未收盘末根。盘中条件可消失；分类和确认时间用法见特征信号。

下面示例以 TSLAUSDT 已订阅为前提：

bash

curl 'https://api.mobiusquant.ai/api/klines?exchange=binance&market=perp&symbol=TSLAUSDT&interval=5m&limit=100'

# 计算数值和特征；绘图时将路径换为 /api/chart。
curl -X POST 'https://api.mobiusquant.ai/api/indicators' \
  -H 'content-type: application/json' \
  -d '{"exchange":"binance","market":"perp","symbol":"TSLAUSDT","interval":"5m","limit":100,"signals":true,"include_forming":true,"calc":[{"name":"macd"},{"name":"rsi"},{"name":"cvd"},{"name":"hmm_regime"}]}'

Hyperliquid 原生永续

使用 exchange="hyperliquid"、market="perp"。仅覆盖默认 USDC 永续市场，不含 Hyperliquid 现货和 HIP-3 合约。

使用 BTCUSDC、ETHUSDC、HYPEUSDC 等标准代码；1000PEPEUSDC 对应原生 kPEPE。不要传 BTC、BTCUSDT、kPEPE 或带 DEX 前缀的代码。
/api/markets/hyperliquid/perp/symbols 返回本服务已订阅的品种，不是交易所全部可交易合约。未订阅品种不能直接计算指标或获取 K 线。
支持 1m / 5m / 15m / 1h / 4h / 1d；实际开放周期和单次返回上限查询 /api/intervals?exchange=hyperliquid&market=perp。
volume 为上游基础资产成交量，quote_volume 为 volume × close 的估算值，不是真实逐笔累计成交额。价格及成交量按该合约单位读取；1000 前缀合约不应当作单个代币报价。
可通过 startTime/endTime 查询开盘时间范围（毫秒、包含边界），无需额外历史参数。上游仅提供最近 5,000 根 K 线，不保证任意历史日期都有结果，也不会提升接口的单次返回配额。
指标、绘图和原生特征继续使用统一接口；HMM 不支持 1m。CVD 仍为 OHLCV 估算量差，不是逐笔主动买卖成交量。
当前未收盘 K 线会更新；需要已确认特征时按特征信号文档读取 true/false/null，不要将历史不足解释为没有特征。

bash

# 查询已订阅的合约和开放周期。
curl 'https://api.mobiusquant.ai/api/markets/hyperliquid/perp/symbols'
curl 'https://api.mobiusquant.ai/api/intervals?exchange=hyperliquid&market=perp'

# 获取 BTC 永续最近 100 根 5m K 线。
curl 'https://api.mobiusquant.ai/api/klines?exchange=hyperliquid&market=perp&symbol=BTCUSDC&interval=5m&limit=100'

# 计算 MACD、RSI、CVD 并返回原生特征；绘图时将路径改为 /api/chart。
curl -X POST 'https://api.mobiusquant.ai/api/indicators' \
  -H 'content-type: application/json' \
  -d '{"exchange":"hyperliquid","market":"perp","symbol":"BTCUSDC","interval":"5m","limit":100,"signals":true,"calc":[{"name":"macd"},{"name":"rsi"},{"name":"cvd"}]}'

A 股(`stock:cn`,32)

canonical = 6 位裸代码(无 sh / sz / bj 前缀,也无 .SS 后缀):

600519(贵州茅台), 601398(工商银行), 601857(中国石油), 601288(农业银行), 601988(中国银行), 601318(中国平安), 600036(招商银行), 601939(建设银行), 600900(长江电力), 601628(中国人寿), 002594(比亚迪), 300750(宁德时代), 000858(五粮液), 000333(美的集团), 600276(恒瑞医药), 688981(中芯国际), 603986(兆易创新), 688041(海光信息), 688256(寒武纪), 603501(韦尔股份), 002371(北方华创), 688012(中微公司), 688521(芯原股份), 300308(中际旭创), 300502(新易盛), 300394(天孚通信), 600487(亨通光电), 601088(中国神华), 601728(中国电信), 002415(海康威视), 600030(中信证券), 601658(邮储银行)

港股(`stock:hk`,20)

canonical = 5 位带前导零(无 .HK 后缀):

00700(腾讯控股), 09988(阿里巴巴), 00941(中国移动), 00939(建设银行), 00388(港交所), 01299(友邦保险), 00005(汇丰控股), 02318(中国平安), 03690(美团), 09618(京东集团), 01810(小米集团), 02020(安踏体育), 00981(中芯国际), 01347(华虹半导体), 00522(ASMPT), 01385(上海复旦), 02382(舜宇光学), 06088(FIT HON TENG), 00763(中兴通讯), 00285(比亚迪电子)

美股(`stock:us`,37)

canonical = 裸 ticker(无后缀):

AAPL, MSFT, GOOGL, AMZN, META, TSLA, LLY, JPM, V, XOM, UNH, JNJ, NVDA, AVGO, AMD, TSM, ASML, INTC, QCOM, TXN, AMAT, LRCX, KLAC, ARM, MU, STX, WDC, COHR, CIEN, LITE, IBIT(BTC ETF), GBTC(BTC ETF), FBTC(BTC ETF), ARKB(BTC ETF), BITB(BTC ETF), ETHA(ETH ETF), ETHE(ETH ETF)

外汇(`forex:spot`,10)

canonical = 6 字母连写({BASE}{QUOTE} 各 3 字母):

EURUSD, USDJPY, GBPUSD, USDCHF, AUDUSD, USDCAD, NZDUSD, EURJPY, GBPJPY, EURGBP

商品期货(`commodity:futures`,7)

canonical = 标准代码(全大写,无分隔符):

XAUF(黄金期货), XAGF(白银期货), WTIUSD(WTI原油), BRNUSD(布伦特原油), NGUSD(天然气), HGUSD(铜), XPTUSD(铂金)

黄金现货

请求参数为 exchange=commodity、market=spot、symbol=XAUUSD。它与黄金期货 commodity:futures / XAUF 独立；不要发送 XAU/USD、GC=F,也不要使用 forex:spot 查询黄金现货。

支持 5m、15m、30m、1h、4h、1d,最小周期为 5m。黄金现货不提供 1m,K 线、指标、图表和 playbook 请求使用该周期均返回 400。
所有周期每 5 分钟更新行情,不是逐笔实时行情。尚未收盘的 K 线会继续修订。
每个周期对外最多返回 1000 根。通过 /api/intervals?exchange=commodity&market=spot 查询黄金周期及容量；不带 venue 参数时返回的是加密市场配置。
复用 /api/klines、/api/indicators、/api/chart,支持 EMA、RSI、MACD 等价格指标。/api/analyze 需使用仅含价格指标的 playbook。
价格为指示性中间价,不是券商可执行报价。没有真实成交量：两个 volume 字段的 0 仅用于格式兼容,data_meta.volume_type="unavailable"。CVD、VWAP、OBV 等量指标返回 400,现有含 CVD 的 market-pulse 不适用于黄金现货。
查看 data_meta.ready、stale、last_sync_ms、data_as_of_ms 和 last_bar_complete 判断就绪、新鲜度与收盘状态。数据未就绪时返回 503；超过 15 分钟未更新的数据带过期标记,超过 1 小时拒绝最新行情查询,历史有界查询仍可返回已有数据。
原始 K 线时间戳为 Unix 毫秒,图表的 time 为秒。日线按 Australia/Sydney 当地 07:00 开盘,4h K 线也按该交易日划分，跨夏令时的实际时长可能变化。

bash

# 先检查服务健康。
curl 'https://api.mobiusquant.ai/api/health'

# 最近 100 根黄金现货 5m K 线。
curl 'https://api.mobiusquant.ai/api/klines?exchange=commodity&market=spot&symbol=XAUUSD&interval=5m&limit=100'

# 黄金现货 5m 的 EMA 与 RSI。
curl -X POST 'https://api.mobiusquant.ai/api/indicators?explain=false' \
  -H 'content-type: application/json' \
  -d '{"exchange":"commodity","market":"spot","symbol":"XAUUSD","interval":"5m","limit":100,"calc":[{"name":"ema","params":{"period":20}},{"name":"rsi","params":{"period":14}}]}'

跨平台 canonical 约定

真实写法	canonical
`BTC-USDT-SWAP`(OKX 永续)	`BTCUSDT`
`BTCPERP`(Bybit USDC 永续)	`BTCUSDC`
`kPEPE`(Hyperliquid)	`1000PEPEUSDC`
`1000PEPEUSDT`(Binance memecoin)	`1000PEPEUSDT`(本身就是)
`00700.HK`(港股腾讯)	`00700`
`600519.SS`(A 股茅台)	`600519`
`GC=F`(黄金期货)	`commodity:futures` 的 `XAUF`

规则:全大写、无分隔符、永续 / 现货由 venue 区分而不是 symbol 后缀。

内置 natural-name(自然语言到 canonical)

用户用「比特币」「茅台」「特斯拉」这种自然语言提到资产时,引擎自带映射表把它解析成 canonical:

bash

curl -H "Authorization: Bearer mq_xxx" \
     "https://api.mobiusquant.ai/api/symbols/search?q=比特币"
# → [{ "canonical": "BTCUSDT", "exchange": "binance", "market": "perp", ... }]

搜索接口内置 smartbox 兜底——不仅限于预设列表,可以发现任意 A 股/港股/美股标的。启用黄金现货后,"黄金"映射为 commodity:spot / XAUUSD；黄金期货仍使用 commodity:futures / XAUF。

完整列表:GET /api/symbols/builtin。

配套接口

Method	Path	说明
GET	`/api/markets`	所有 venue + WS 健康状态
GET	`/api/markets/{exchange}/{market}/symbols`	单 venue 的全品种列表
GET	`/api/intervals`	支持的周期和最大返回根数
GET	`/api/klines`	原始 OHLCV
GET	`/api/symbols/builtin`	natural-name → canonical 映射表
GET	`/api/symbols/search?q=`	自然语言模糊查 canonical(含 smartbox 兜底)
GET	`/api/health`	每个 venue 的实时状态(`ok` / `degraded` / `dead` / `starting`)
GET	`/api/derivatives/funding-rates`	资金费率历史(Binance / Bybit / OKX)
GET	`/api/derivatives/open-interest`	持仓量历史(Binance)
GET	`/api/derivatives/long-short-ratio`	大户多空比(Binance)
GET	`/api/derivatives/taker-ratio`	主动买卖比(Binance)
GET	`/api/sentiment/fear-greed`	加密恐惧与贪婪指数

详细字段说明见 API 在线文档。衍生品与情绪数据的完整接口文档见衍生品与情绪数据。

支持的行情品种 ​

总览 ​

指定时间的历史查询 ​

交易所品种 ​

binance:spot(70) ​

binance:perp ​

bybit:spot(70) ​

bybit:perp(70) ​

okx:spot(70) ​

okx:perp(50) ​

币安股票永续 ​

Hyperliquid 原生永续 ​

A 股(stock:cn,32) ​

港股(stock:hk,20) ​

美股(stock:us,37) ​

外汇(forex:spot,10) ​

商品期货(commodity:futures,7) ​

黄金现货 ​

跨平台 canonical 约定 ​

内置 natural-name(自然语言到 canonical) ​

配套接口 ​

支持的行情品种

总览

指定时间的历史查询

交易所品种

`binance:spot`(70)

`binance:perp`

`bybit:spot`(70)

`bybit:perp`(70)

`okx:spot`(70)

`okx:perp`(50)

币安股票永续

Hyperliquid 原生永续

A 股(`stock:cn`,32)

港股(`stock:hk`,20)

美股(`stock:us`,37)

外汇(`forex:spot`,10)

商品期货(`commodity:futures`,7)

黄金现货

跨平台 canonical 约定

内置 natural-name(自然语言到 canonical)

配套接口