核心功能与用法
Finam Trade API Skill 是俄罗斯老牌券商 Finam 的官方程序化交易接口，支持通过命令行执行完整的投资 workflow：从资产查询、行情获取到下单交易。
核心功能模块：
- 账户管理：查询投资组合、持仓盈亏、资金余额
- 市场数据：实时报价、订单簿、最近成交、多周期历史K线（1分钟至季度）
- 交易执行：支持限价单与市价单，买卖双向操作
- 资产浏览：预置俄美市场前100大流动性股票清单，支持按交易所MIC代码筛选
- 波动率扫描：内置Python脚本，基于60日收盘价计算年化波动率，筛选高波动标的
- 市场资讯：RSS抓取俄美市场新闻（无需认证）
使用前提：需注册Finam账户，从官网获取 FINAM_API_KEY 和 FINAM_ACCOUNT_ID，首次使用前需获取15分钟有效的JWT Token。
符号规范：所有标的采用 ticker@mic 格式，如 SBER@MISX（俄储蓄银行）、AAPL@XNGS（苹果纳斯达克）。
显著优点
1. 券商官方直连：非第三方封装，数据延迟低，执行可靠性高
2. 覆盖双市场：同时支持莫斯科交易所（MISX/RUSX）与美股主要交易所（NYSE/NASDAQ）
3. 历史数据丰富：支持多周期OHLCV，适合回测与技术分析
4. 轻量无依赖：纯curl+shell实现，配合jq即可运行，易于集成至CI/CD或crontab
5. 预置工具链：内置波动率扫描与资产清单，开箱即用
潜在局限与风险
- 地域限制：Finam主要服务俄语区客户，开户与客服以俄语为主
- Token时效短：15分钟JWT需频繁刷新，生产环境需额外封装自动续期逻辑
- 无websocket推送：行情为轮询模式，非实时流式推送
- 文档语言：官方文档俄文为主，英文支持有限
- 制裁风险：受国际制裁影响，俄券商API存在服务中断或支付通道受限的可能
适合人群
- 俄语区活跃交易者、量化策略开发者
- 需要同时交易俄股与美股的跨境投资者
- 偏好轻量级CLI工具、避免臃肿SDK的技术型用户
- 对低延迟交易执行有要求的日内交易者
常规风险提示
- 资金安全：API密钥具备交易权限，需妥善保管，避免硬编码或泄露
- 合规风险：跨境证券交易需遵守当地外汇管制与税务申报要求
- 市场风险：波动率扫描工具基于历史数据，不预示未来走势
- 执行风险：市价单在流动性不足时可能产生滑点，限价单存在不成交风险
- 服务连续性：地缘政治因素可能导致API服务受限或账户冻结