衍生品研究员
重点关注 risk 模块的定价与风险能力。
gs-quant / Architecture
gs-quant 架构：模块化设计
gs-quant 以 gs_quant 包为入口，把认证（session）、市场与工具（markets）、定价与风险（risk）、回测（backtests）、时间序列（timeseries）、组合（portfolio）、数据（data）组织成模块化体系。
sessionGsSession 认证
markets市场与工具
dataMarquee 数据
risk定价/风险
backtests回测
timeseries时间序列
portfolio组合
Modules
核心模块清单
以下模块名称与职责来自 gs-quant 官方文档口径（2026-09 核验）。
| 模块 | 职责 | 典型用途 |
|---|---|---|
| gs_quant.session | 认证与连接 | GsSession 用 client_id/client_secret 登录 |
| gs_quant.markets | 市场与金融工具 | 证券/指数等工具建模 |
| gs_quant.risk | 定价与风险分析 | 期权定价、greeks、情景、风险度量 |
| gs_quant.backtests | 策略回测 | 定义策略、跑历史数据、看回测结果 |
| gs_quant.timeseries | 时间序列分析 | 收益、波动率等时序计算 |
| gs_quant.portfolio | 组合分析 | 组合构建、风险归因、组合指标 |
| gs_quant.data | 数据访问 | Marquee 数据集查询 |
说明：模块边界与命名以官方文档为准；本表用于理解职责划分，不含未验证集成或性能承诺。
Who fits
适用人群
模块化设计面向会写 Python 的量化研究与金融工程用户。
策略开发者
重点关注 backtests 回测能力。
组合管理者
重点关注 portfolio 组合分析能力。
Troubleshooting
模块使用常见报错排查
使用各模块时常见的问题与排查建议。
| 报错 / 现象 | 可能原因 | 排查建议 |
|---|---|---|
| 导入子模块报 ModuleNotFoundError | 依赖未装或版本不符 | 核对依赖并升级到官方要求版本 |
| session 未初始化 | 未调用 GsSession 登录 | 先建立 GsSession 再调用数据接口 |
| 数据调用返回空 | 账号无对应 entitlement | 确认数据授权范围 |
| 模块间数据格式不符 | 工具/数据定义不一致 | 检查传入的工具对象与数据格式 |
FAQ
常见问题
gs_quant 是单模块还是多模块？
是多模块包，session/markets/risk/backtests/timeseries/portfolio/data 等各司其职。
哪个模块负责认证？
gs_quant.session（GsSession）负责 OAuth 认证与连接。
模块之间有依赖吗？
数据访问通常先经 session 认证，再由 data 模块取数，供其他模块使用。