工具

数据源

一次 get_market_data 调用可以用到 28 个数据源。source 设为 auto 时,每个代码按所属市场路由,沿该市场的回退链依次尝试,最不容易封禁你的数据源排在最前。

回退链

市场回退顺序
A 股tencent、eastmoney、baostock、akshare、tushare、local
美股yahoo、stooq、sina、eastmoney、yfinance、tiingo、fmp、finnhub、alphavantage、longbridge、akshare、local
港股tencent、eastmoney、yahoo、futu、akshare、yfinance、tushare、longbridge、local
印度yahoo、yfinance、india_broker、local
韩国pykrx、yahoo、yfinance、local
加拿大、英国、越南、阿根廷、指数yahoo、yfinance、local
加密货币okx、binance、ccxt、yfinance、local
国内期货akshare、local
外汇与贵金属mt5、akshare、yfinance、local
基金tushare、akshare、local
宏观akshare、tushare、local

以下数据源只在你点名时使用:gildata(需先启用聚源行情)、tickerall(托管的 MT5 行情)、nobitex / wallex(伊朗托曼计价交易对)。设置 MARKET_DATA_ORDER_<MARKET>(例如 MARKET_DATA_ORDER_US_EQUITY)可以调整某条链的顺序。

基础安装包含使用标准库 HTTP 的腾讯行情加载器和 AKShare。BaoStock 是可选的免 token TCP 日线数据源,可用 pip install --upgrade "vibe-trading-ai[ashare]" 安装;原先只安装基础包的 uv tool 用户可运行 uv tool install --force --python 3.12 "vibe-trading-ai[ashare]"。自动回退会跳过缺少可选 SDK 的加载器。

uv tool 的 --force 会重建现有工具环境。添加 ashare 时须保留原先使用的其他 extra(例如 "vibe-trading-ai[ashare,deepseek]"),并在命令中重复原有的 --with 参数,以保留这些附加依赖。

旧版 mootdx 加载器也仅供显式指定:它已退出自动回退链,基础安装和 ashare extra 都不包含它。安装 SDK 并不能保证与 TDX 服务器协议兼容。东方财富相关请求遇到限流时,可使用 source: "auto",或选择可用的 tencent、baostock 等替代源。启动预检只覆盖部分服务,不会列出所有可选加载器;SDK 已安装也不代表远端服务当前可用。

代码格式

市场示例
A 股600519.SH、000001.SZ
港股0700.HK
美股AAPL.US、SPY.US——必须带后缀
加密货币BTC-USDT(大写,连字符)
韩国 / 印度 / 英国 / 加拿大005930.KS、RELIANCE.NS、VOD.L、SHOP.TO
越南 / 阿根廷VNM.VN、GGAL.BA
国内期货RB0(主力连续)、IF2412
外汇与贵金属EURUSD、XAUUSD
你自己的文件local: 前缀——CSV、Parquet 或 DuckDB

后缀只表示交易所,不表示币种。伦敦的报价必须声明 GBP 或 GBp;港股按股票代码所属区段的币种计价。

指定数据源

直接用自然语言说("用长桥取 QQQ.US 的历史数据"),或在回测配置里设置 "source"。明确写了 local: 的代码绝不会回退到网络数据源。

行情之外

22 个只读数据工具,覆盖资金流向、龙虎榜、北向资金、融资融券、大宗交易、股东户数、限售解禁、板块、研报、新闻、SEC 公告、财务报表、期权链、公司概况、条件选股、代码搜索、宏观序列、问财、13F 机构持仓、ETF 穿透、预测市场和学术论文。