FinBridge
QUANT RESEARCH INFRASTRUCTURE
GitHub · EpocheRan/FinBridge
FINBRIDGE / 01 OPEN-SOURCE QUANT RESEARCH

The infrastructure
behind A-share
alpha.

FinBridge 把数据契约、因子物化、选股、回测与研究报告,收进一条可复现的研究链路;所有能力通过 MCP 开放给 AI Agent。

GITHUB ↗
11 MODULES 85+ FACTORS MCP NATIVE
SCROLL TO EXPLORE ↓

系统架构与数据流

自上而下:数据源 → 采集编排 → 数据访问 → 统一存储 → 计算/应用 → 工具出口。虚线表示事件、派生或无强耦合的读取。

ARCHITECTURE / v2.1
acquisition · 采集编排 Scope → Orchestrator.run(REAL_SYNCERS) · BuildOrchestrator.ensure_snapshot 增量 · 断点续跑 · 快照调度 data_interface · 唯一数据访问层 QuestDBClient · MarketDataLoader.ohlc · FinancialDataService.get_statements · SentimentService.sync raw 表唯一写者 · 归一化 · 复权 统一时序存储 · 唯一事实源 QuestDB · WAL + DEDUP UPSERT factors · 纯计算 F.* 声明 · build_panel · compute_series 0 DB 依赖 pandas / numpy only factor_engine · 因子物化 build / ensure / read_latest · FactorStore factor 表唯一写者 registry · 长表 · latest · 对账 position · 持仓与交易台账 PositionManager · ATR / Grid 模式 · compute_ledger 行情经 data_interface 组合 → 持仓 → 逐笔成交 strategies · 策略基类 rank / weights / target_weight 仅依赖 factors STRATEGY 模块变量 backtest · 回测撮合 run / optimize / walkforward T+1 · 涨跌停 RQAlpha · 自建账本 screener · 选股 ScreenSpec · screen() · rebuild 0 直连 DB 覆盖率 · 停牌过滤 research · 因子报告 profile · panel cache · render 章节 + 样本敏感性 全市场 · 只输出 HTML MCPserver · 统一工具出口 HTTP / stdio · market · financial · moneyflow · concept · disclosure · factor · acquisition · screener · position FastMCP 触发 sync_* · 发 DataWritten UPSERT 写入 SQL 读取 读 raw 表 · 写 factor_* 表 stored 因子 read_latest 注册为 MCP 工具
同步调用 事件 / 派生 / 弱耦合读取 所有 DB 访问仅限 data_interface 与 factor_engine 持仓表非 WAL(支持原地 UPDATE)

为什么是 FinBridge

不是又一个数据管道:把「研究结论可复现」写进模块边界、因子资产与报告口径。

WHY FINBRIDGE
01 / PIPELINE

一条链路,四层边界

采集、数据访问、因子计算与应用分层;单向依赖让每层可以独立替换与测试。

02 / FACTOR

因子是资产,不是脚本

声明式 FactorDef → registry → 长表 / latest;方向、单位、版本与依赖全部可追溯。

03 / RESEARCH

报告经得起复核

profile 章节、分层 IC(流动性/市值/行业)、五维评分、ALL/EX_BSE/INVESTABLE/HIGH_LIQ 样本敏感性、分月 IC 与失效归因;HTML 报告与评分逻辑同源,Panel 缓存可复用。

04 / BACKTEST

A 股规则内置

T+1、整手、涨跌停、停牌、佣金与印花税;单标的与横截面共用一套账本。

05 / MCP

MCP 原生

行情、财务、因子、选股、持仓与同步统一暴露为工具,AI Agent 可直接调用。

06 / REPRODUCIBLE

可复现的运行

run_id 固化策略、参数、数据快照与执行规则;同输入可重跑,结论可对照。

11 Modules · Responsibility & Public API

模块职责、核心函数与依赖

每个模块只做一件事,并用明确的读写边界与相邻模块连接。点击底部的表名可直接跳转到数据模型并打开字段详情。

模块卡片

函数名为代码中的真实入口(类名 + 方法名),不是概念描述。

Entity Map · 7 Data Domains

数据模型与表关系

按数据域分列布局。连线是逻辑关系(存储层无外键约束),虚线表示派生 / 投影。点击任意表查看字段、读写方与上下游。

滚轮缩放 · 拖拽平移 · 点击表看字段 · 点击数据域聚焦
逻辑外键 派生 / 投影 状态 / 作业 其余表以 code 关联主数据;ts 为 designated timestamp