SuperAPI AI 工具集

data-routing

数据与分析

查看项目

更新于 10-15 22:13

技能介绍

用途:这是一个统一的数据路由技能(Router)。它把已注册的回测数据源映射到对应市场、认证要求与配套技能,也把研究类数据需求映射到具体工具、覆盖市场与所需环境变量。技能说明指出,所列源名是 backtest.loaders.registry.VALID_SOURCES 的严格子集,并由测试文件校验。在任何回测、取数或研究任务之前应先加载本技能,以便选择最佳可用源。

主要能力:一是数据源总览,覆盖 tushare、akshare、yfinance、okx、nobitex、wallex、ccxt、baostock、tencent、mootdx、futu、mt5、tickerall、local、eastmoney、sina、stooq、yahoo、finnhub、alphavantage、tiingo、fmp、gildata、qveris 等,逐项标明市场、认证(环境变量)、网络要求与配套技能。二是能力到工具的路由表,例如行情 K 线用 get_market_data,资金流向用 get_fund_flow,龙虎榜用 get_dragon_tiger,北向资金用 get_northbound_flow,融资融券用 get_margin_trading,大宗交易用 get_block_trades,股东户数用 get_shareholder_count,限售解禁用 get_lockup_expiry,板块信息用 get_sector_info,卖方研报用 get_research_reports,个股新闻用 get_stock_news,SEC 申报用 get_sec_filings,财务报表用 get_financial_statements,期权链用 get_options_chain,个股概况用 get_stock_profile,选股用 screen_market,代码搜索用 search_symbol,宏观 FRED 序列用 get_macro_series,问财自然语言检索用 iwencai_search。

使用方式:回测场景写 config.json 时建议使用 source: "auto",由 runner 按代码格式路由并在同市场源间自动回退,仅在用户明确要求时指定具体源。研究场景先识别数据需求,再查能力表获取工具与环境变量;纯 OHLCV 需求调用 get_market_data 并让源回退生效;调用需密钥的工具前先设置环境变量,缺失时应报告缺少的密钥而不是静默失败。代码格式有约定,例如 A 股 NNNNNN.SZ/SH/BJ,美股 TICKER.US,港股 NNNNN.HK,加密 SYMBOL-USDT 等。

适用场景与限制:适用于 A 股、美股、港股、加拿大、加密、期货、外汇与宏观等多市场数据获取与回测。源存在优先级,如 A 股优先 tencent/mootdx、美股优先 stooq/yahoo、加密优先 okx 等。部分源受 IP 限流(eastmoney、sina、yahoo)须节流并回退;需密钥的源缺失密钥时不可用,应改走同市场免费源;单个代码失败以错误信息返回,不会中止整个批次。说明还强调数据核验纪律:关键数字应跨至少两个独立来源交叉核对,偏差超过 1% 应标注口径差异,未核验数字标注为单源或估算。文档中未提供具体价格与收费细节。