工具
数据源
一次 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 穿透、预测市场和学术论文。