The single ROUTER for every data need. Load this skill BEFORE any backtest, data-fetch, or research task to pick the best available source/tool, honour auth (en
复制下面这句话，粘贴给 Claude Code、Codex、Cursor 等 AI 编程工具，它会读取安装说明并在你确认后完成安装。
请阅读 https://ai.atlankj.com/install/asset/gh-data-routing-a043b191a8b3 ，按照其中的说明把「data-routing」安装到你（当前 AI 工具）中。执行前先告诉我将运行的命令和写入的位置，等我确认。
查看 AI 将读取的安装说明正在读取 GitHub 原文…
内容来自 GitHub 原始文件，由原作者维护。在 GitHub 查看
This is the one router. It maps (a) every registered backtest data source to its
markets / auth / skill, and (b) every research data need to the concrete tool
that serves it, its market, and the env key it requires. Source names below are a
strict subset of backtest.loaders.registry.VALID_SOURCES (enforced by
tests/test_data_routing_sources_subset.py).
Every name here is a registered OHLCV/backtest source in VALID_SOURCES.
"Runner-internal" sources are selected by the backtest runner, not authored as a
per-source skill.
| Source | Markets | Auth (env key) | Network | Skill |
|---|---|---|---|---|
| tushare | A-shares, funds, futures, macro | Yes (TUSHARE_TOKEN) | China network | tushare |
| akshare | A-shares, US, HK, futures, macro, forex | No | Unrestricted | akshare |
| yfinance | US, HK, Canada (TSX/TSXV) stocks, ETFs | No | Needs Yahoo access | yfinance |
| okx | Crypto (OKX exchange) | No | Needs okx.com access | okx-market |
| nobitex | Crypto, IRT/Toman-quoted pairs (BTC-IRT, USDT-IRT — Iran market premium) | No | Needs apiv2.nobitex.ir access | data-routing (explicit *IRT routing only) |
| wallex | Crypto, TMN/Toman-quoted pairs (USDT-TMN, BTC-TMN — Iran market premium) | No | Needs api.wallex.ir access | data-routing (explicit *TMN routing only; truly serves 1m/1h/1d) |
| ccxt | Crypto (100+ exchanges) | No | Needs exchange access | ccxt |
| baostock | A-shares (free daily/min) | No | China network | data-routing |
| tencent | A-shares, HK, US (never-banned) | No | Unrestricted | data-routing |
| mootdx | A-shares (TDX servers, never-banned) | No | China network | data-routing |
| futu | A/HK/US via OpenD gateway | Yes (OpenD running) | Local gateway | data-routing (runner-internal) |
| mt5 | Forex & metals (your broker's MT5 feed) | Yes (running, logged-in MT5 terminal; optional ~/.vibe-trading/mt5.json) | Local terminal (Windows) | data-routing (runner-internal) |
| tickerall | Forex & metals (same broker MT5 feed, hosted) | Yes (TICKERALL_API_KEY + TICKERALL_ACCOUNT_ID; read-only) | Hosted API (any OS, no terminal) | data-routing (runner-internal; explicit source=tickerall only) |
| local | User CSV/parquet on disk | No | Offline | data-routing (runner-internal) |
| eastmoney | A-shares, HK, US equities | No (IP-throttled) | Unrestricted | data-routing |
| sina | US equities (daily OHLCV) | No (IP-throttled) | Unrestricted | data-routing |
| stooq | US equities (daily OHLCV) | No | Unrestricted | data-routing |
| yahoo | US, HK, Canada (TSX/TSXV) equities | No (IP-throttled) | Needs Yahoo access | data-routing |
| finnhub | US equities | Yes (FINNHUB_API_KEY) | Unrestricted | data-routing |
| alphavantage | US equities | Yes (ALPHAVANTAGE_API_KEY) | Unrestricted | data-routing |
| tiingo | US equities | Yes (TIINGO_API_KEY) | Unrestricted | data-routing |
| fmp | US equities | Yes (FMP_API_KEY) | Unrestricted | data-routing |
| gildata | A-shares (Hundsun Juyuan commercial feed, forward-adjusted dailies) | Yes (GILDATA_TOKEN / Settings) | Gildata MCP API | data-routing |
| qveris | Global multi-asset (paid, credits) | Yes (QVERIS_API_KEY / Settings) | QVeris API | qveris |
Pick the tool by the data need. "Market" is the universe the tool covers; "Env key" is required only where listed (no key listed = free / no auth).
| Data need | Tool | Market | Env key |
|---|---|---|---|
| OHLCV price bars | get_market_data | A-share / US / HK / Canada / crypto / futures / forex | per-source (see Source Overview) |
| Fund flow (资金流向) | get_fund_flow | A-share, HK, US | — |
| Dragon-tiger (龙虎榜) | get_dragon_tiger | A-share | — |
| Northbound flow (北向资金) | get_northbound_flow | A-share | — |
| Margin trading (融资融券) | get_margin_trading | A-share | — |
| Block trades (大宗交易) | get_block_trades | A-share | — |
| Shareholder count (股东户数) | get_shareholder_count | A-share | — |
| Lockup expiry (限售解禁) | get_lockup_expiry | A-share | — |
| Sector / board taxonomy (板块) | get_sector_info | A-share | — |
| Sell-side research reports | get_research_reports | A-share | — |
| Stock news | get_stock_news | A-share, US, HK | — |
| SEC filings (EDGAR) | get_sec_filings | US | — |
| Financial statements | get_financial_statements | A-share, US, HK | — |
| Options chain | get_options_chain | US | — |
| Stock profile / fundamentals | get_stock_profile | US | — |
| Market screen | screen_market | A-share | — |
| Symbol search | search_symbol | A-share, US, HK, Canada, crypto/index/FX | — |
| Macro / FRED series | get_macro_series | Macro (US/global) |
Notes:
get_financial_statements reads US statements from SEC EDGAR companyfacts
(ticker -> CIK -> XBRL concepts) and A-share/HK statements from the Eastmoney
datacenter report API (per-market F10 report names).get_stock_news routes A-share (SH/SZ/BJ) to an Eastmoney news client and
US (.US) / HK (.HK) to a Yahoo search client; a failure on one upstream is
returned as an error envelope, never raised, so a single bad symbol never
aborts a batch.Use source: "auto" — the runner routes by symbol pattern and falls back across
same-market sources automatically. Only set a concrete source when the user asks.
get_market_data and let source fallback run.TUSHARE_TOKEN) >
baostock / akshare > eastmoney (throttled).TUSHARE_TOKEN) / longbridge (key-gated)..TO / .V suffixes (for example TD.TO, PNG.V).source="tickerall") is a hosted, no-terminal alternative to the same broker feed (any OS) — opt-in and explicit-only: it never joins this automatic chain, so a user's broker credential is used only when deliberately requested.| Market | Format | Examples |
|---|---|---|
| A-shares | NNNNNN.SZ/SH/BJ | 000001.SZ, 600000.SH, 430139.BJ |
| US stocks | TICKER.US | AAPL.US, MSFT.US |
| HK stocks | NNNNN.HK | 00700.HK, 09988.HK |
| Canada TSX / TSXV | TICKER.TO / TICKER.V | TD.TO, BBD-B.TO, PNG.V |
| Crypto | SYMBOL-USDT | BTC-USDT, ETH-USDT |
| Futures | XXNNNN.EXCHANGE | CU2406.SHFE |
| Forex | XXX/YYY | USD/CNY, EUR/USD |
tencent and mootdx have no observed IP ban;
reach for them first for A-share OHLCV when no token is set.FINNHUB_API_KEY,
ALPHAVANTAGE_API_KEY, TIINGO_API_KEY, FMP_API_KEY, FRED_API_KEY,
VIBE_TRADING_IWENCAI_KEY, TUSHARE_TOKEN). If the key is absent the tool/loader
is unavailable — route to a free same-market source instead of erroring out.When a number will drive a conclusion (valuation, screening, report), do not trust a single source. Cross-check it:
financial_rigor tool's cross_validate command to do this exactly:
pass {source: value, ...} and it returns the median consensus + per-source
deviation + an all_consistent flag at a configurable tolerance (default 2%).This discipline is what separates analysis from aggregation.
FRED_API_KEY |
| iWenCai NL search (问财) | iwencai_search | A-share | VIBE_TRADING_IWENCAI_KEY |