核心用法
Finam Skill 是连接俄罗斯老牌券商 Finam 官方交易 API 的桥梁，提供完整的 REST 与 gRPC 双栈能力。用户可通过标准化环境变量完成认证（FINAM_API_KEY + FINAM_ACCOUNT_ID），获取 15 分钟有效期的 JWT Token 后即可调用全量功能。
市场数据层：支持 Moscow Exchange（MISX）、NASDAQ（XNGS/XNMS）、NYSE（XNYS）等主流交易所的实时行情（报价、订单簿、成交明细）与历史 K 线（OHLCV），时间粒度从 1 分钟到季度线共 12 档，最长可回溯 5 年数据。资产检索支持通配符搜索与按类型过滤（股票、期货、债券、基金等）。
交易执行层：提供限价单与市价单两种基础类型，下单前强制二次确认流程。支持订单状态查询与撤单操作。所有交易指令均通过 HTTPS 加密传输。
分析工具层：内置 Top-100 流动性股票预排序列表与波动率扫描器（基于 60 日收盘价年化波动率），可快速识别俄美市场的高波动标的。
双协议架构：REST 适合历史数据回测、账户信息查询及低频交易；gRPC 提供实时数据流订阅与低延迟订单通道，适合事件驱动型策略与高频场景。
显著优点
- 官方直连：Finam 为俄罗斯持牌券商（T1 级），API 直接对接交易所，无中间商数据延迟
- 覆盖双市场：同时支持俄罗斯本土市场（MISX/RUSX）与美国三大交易所，跨境策略友好
- 工具链成熟：提供 Python 辅助脚本（资产搜索、波动率计算）与第三方 gRPC 库 FinamPy，降低开发门槛
- 安全合规：HTTPS 全链路加密，JWT Token 短时效机制减少密钥泄露风险
潜在缺点与局限性
- 地域限制：Finam 主要服务俄语区客户，英文文档不完善，非俄语用户上手门槛较高
- Token 管理负担：15 分钟 JWT 过期机制需频繁刷新，脚本化交易需额外实现 Token 自动续期
- 功能边界：仅支持基础订单类型（限价/市价），缺乏条件单、冰山单等高级指令
- 数据深度限制：分钟级数据最大 7-30 天，历史查询需分段拼接
- 监管风险：受俄罗斯央行监管，国际制裁环境下可能出现服务中断或资金流动限制
适合人群
- 俄罗斯本土及东欧地区活跃投资者
- 跨境量化策略开发者（俄美双市场套利、统计套利）
- 需要替代数据源验证美股行情的研究人员
- Python 技术栈的中低频交易系统开发者
常规风险
- 资金安全风险：API 密钥泄露可能导致账户被恶意交易，建议启用 IP 白名单并定期轮换密钥
- 市场极端波动风险：俄市场流动性在危机时期可能骤降，市价单滑点不可控
- 技术故障风险：15 分钟 Token 机制在高频场景下若刷新失败将导致交易中断
- 合规与制裁风险：需持续关注国际制裁动态，评估账户资金冻结可能性
- 汇率与结算风险：跨境资金划转涉及卢布-美元汇率波动及俄罗斯资本管制政策影响