核心用法
polygon-api 是一款面向开发者的金融数据 CLI 工具，基于 npx 运行，封装了 Polygon（现 Massive）全套 API 能力。用户配置 POLY_API_KEY 环境变量后，通过 npx massive <command> 即可调用各类金融数据接口，所有命令均以 JSON 格式输出至标准输出，便于脚本化集成和数据管道处理。
工具覆盖七大核心模块：
- Stocks：股票实时行情、历史 OHLC、逐笔成交等
- Crypto：加密货币市场数据与交易对信息
- Forex：外汇汇率及交叉盘数据
- Options：期权链、隐含波动率、希腊字母等衍生品数据
- Indices：全球主要指数行情与成分股
- Reference Data：股票代码映射、公司信息、交易日历等元数据
- Market & News：市场状态检测与财经新闻流
显著优点
1. 一站式多资产覆盖：单工具整合股债汇期权加密资产，无需切换多个供应商
2. 开发者友好：纯 JSON 输出、nix 风格管道设计，天然适配自动化工作流
3. 零安装负担：npx 即时执行，无需全局安装或维护依赖版本
4. 专业级数据质量：底层依托 Polygon/Massive 机构级金融数据基础设施
潜在缺点与局限性
- 付费门槛：Polygon API 按调用量分级计费，高频或历史数据需求成本显著
- 地域合规限制：部分市场数据（如 A 股、印度股）覆盖有限，受交易所授权约束
- 无图形界面：纯 CLI 形态对非技术用户不友好，需配合 jq 等工具做数据可视化
- 网络稳定性依赖：实时行情对延迟敏感，跨境使用可能存在连通性波动
适合人群
量化研究员、算法交易员、金融科技开发者、数据工程师，以及需要程序化获取美港股及全球衍生品数据的专业用户。
常规风险
- API 密钥泄露：
POLY_API_KEY需妥善保管，误提交至代码仓库可能导致配额被盗刷 - 数据使用合规：金融数据存在再分发限制，商业化用途需确认 Polygon 授权条款
- 延迟与精度声明：免费/低价档位数据可能存在 15 分钟延迟，实盘交易需核实实时性