核心用法
massive-api 是 Massive（原 Polygon）金融数据平台的命令行封装工具，通过 npx 零安装运行，提供覆盖多资产类别的市场数据访问能力。
主要功能模块：
- 股票数据：美股实时行情、历史价格、成交量、公司基本面
- 加密货币：主流币种价格、交易对、市场深度
- 外汇（Forex）：货币对汇率、历史走势
- 期权链：期权报价、 Greeks 指标、到期日结构
- 指数与期货：全球主要指数、商品期货数据
- 新闻与参考数据：财经新闻、市场状态、交易所信息
使用模式：
# 全局调用（无需本地安装） npx massive <command> [options] # 输出格式 所有命令默认返回结构化 JSON，便于管道处理和程序解析
认证方式：
需配置 MASSIVE_API_KEY 环境变量，采用标准 API Key 鉴权。
显著优点
1. 即开即用：依托 npx 实现零依赖部署，无需全局安装或维护版本
2. 资产覆盖广：单一工具覆盖传统金融与加密数字资产，适合跨市场策略
3. 结构化输出：JSON 格式原生支持自动化工作流，与 Python/Node/Shell 无缝集成
4. 参考文档完善：按资产类别拆分详细命令参考（stocks、crypto、forex、options 等）
潜在缺点与局限性
1. 商业 API 成本：Massive/Polygon 为付费服务，高频调用或历史数据下载可能产生显著费用
2. 地域限制：数据源以美股、北美市场为主，亚太/A股覆盖有限
3. CLI 封装层依赖：实际数据质量与稳定性取决于上游 Polygon API，非独立数据源
4. 无图形界面：纯 CLI 工具，需具备命令行基础，不适合非技术用户
适合人群
- 量化研究员与算法交易员：快速获取标准化市场数据用于回测与实盘
- 金融科技开发者：构建数据管道、监控机器人、自动化报告系统
- 数据分析师：通过 Shell/Python 进行批量历史数据拉取与清洗
- 个人投资者开发者：自建行情看板、预警系统的技术型用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `MASSIVE_API_KEY` 需妥善保管，避免提交至代码仓库或日志暴露 |
| 配额超限费用 | 未设置调用限制可能导致意外账单，建议配置用量监控与告警 |
| 数据延迟 | 免费/低价套餐可能存在 15 分钟延迟，实时交易需确认订阅等级 |
| 服务依赖 | Polygon API 变更或中断将直接影响本工具可用性 |
| 合规风险 | 金融数据使用需遵守 Polygon 服务条款及当地证券法规 |