核心用法
Finam Trade API 是俄罗斯券商 Finam 提供的程序化交易接口，覆盖莫斯科交易所（MISX/RUSX）及美股（NASDAQ/NYSE）两大市场。技能支持完整的交易生命周期：资产搜索（支持通配符与类型过滤）、实时行情获取（报价/订单簿/成交/历史K线）、订单管理（市价/限价单、查询、撤单）及组合持仓查询。特色功能包括预计算的Top100流动性股票列表、60日历史波动率扫描器，以及无需认证的RSS新闻源。
技术层面，REST API 适合低频数据获取与历史回测，gRPC 则面向低延迟实时订阅场景。认证采用 JWT 模式，需先用 API Key 换取 Token（15分钟有效期），配合 accountId 可获取账户专属字段（保证金、可用数量等）。
显著优点
- 市场覆盖完整：同时支持俄股与美股，MIC代码规范清晰（MISX/XNGS等）
- 数据维度丰富：从Tick级成交到月度K线，含订单簿深度与波动率分析工具
- 双协议灵活：REST便于快速开发，gRPC满足低延迟量化策略需求
- 无门槛新闻接口：RSS源无需JWT即可获取俄/美市场要闻
- 本地预处理数据：Top100股票列表与交易所清单本地缓存，减少API调用
潜在缺点与局限性
- Token生命周期短：15分钟过期需频繁刷新，增加代码复杂度
- 环境变量依赖重：必须预置 FINAM_API_KEY / FINAM_ACCOUNT_ID，无交互式配置
- 美股数据深度有限：相比俄股，美股实时订阅需评估 gRPC 稳定性
- 无模拟交易环境：文档未提及沙箱，实盘前测试成本较高
- 依赖外部工具链：需 curl/jq/python3，Windows原生支持较弱
适合人群
- 俄罗斯市场量化交易者及跨境资产配置者
- 已有 Finam 账户、熟悉 shell/Python 的技术型投资者
- 需要同时监控俄股+美股的分散化策略开发者
- 对15分钟Token刷新机制可接受的中高频策略（非超低延迟HFT）
常规风险
1. 认证失效风险：Token过期导致交易中断，需设计自动刷新逻辑
2. 时区与格式错误：RFC 3339时间格式严格，endTime为开区间易踩坑
3. 订单确认义务：技能强制要求人工确认订单细节，自动化脚本需显式处理交互
4. 汇率与跨境结算：美股交易涉及货币兑换，API未暴露相关成本字段
5. 依赖单一券商：Finam为俄罗斯受监管券商，需关注地缘政治相关合规变化