核心用法
polygon-api 是一个基于 Bun 运行时开发的命令行工具及 JavaScript 客户端封装，用于调用 Polygon（现 Massive）金融数据 API。用户通过 bun cli.js <command> [options] 执行各类市场数据查询，所有命令默认输出 JSON 格式至标准输出，便于管道化处理与自动化脚本集成。
该技能覆盖六大核心资产类别：
- Stocks：美股实时行情、历史数据、 aggregates
- Crypto：加密货币现货与衍生品市场数据
- Forex：外汇即期与远期汇率数据
- Options：期权链、希腊值、隐含波动率等衍生品数据
- Indices：全球主要指数行情与成分股信息
- Futures：期货合约行情与历史数据
此外提供 Reference Data（证券基本信息、交易所代码映射）、Market（市场状态、交易日历）及 News（财经新闻源）等辅助模块。
显著优点
1. 数据覆盖全面：单一路径聚合股票、加密、外汇、期权等多资产类别，避免多供应商集成复杂度
2. CLI 优先设计：JSON 输出天然适配 DevOps 工作流，易于与 jq、Python 分析管道或监控告警系统集成
3. Bun 运行时：启动速度快、内存占用低，适合高频脚本调用场景
4. 模块化文档：各资产类别独立命令参考文档，降低学习曲线
潜在缺点与局限性
- API Key 依赖：需自行注册 Polygon/Massive 并获取
POLY_API_KEY，免费额度有限，高频调用需付费升级 - 地域与合规限制：部分实时行情数据可能受交易所延迟规则（如 15 分钟延迟）或地区订阅等级约束
- 非官方封装：为社区/第三方封装工具，非 Polygon 官方维护，API 变更时可能存在滞后
- Bun 生态限制：Node.js 兼容性良好但特定边缘场景可能需额外测试
适合人群
- 量化开发者与数据工程师：需要程序化获取多资产市场数据
- DevOps/SRE：构建市场监控、异常检测等自动化运维脚本
- 金融科技初创团队：快速验证策略原型，避免自建数据基础设施
- 个人交易者：开发自定义分析工具或回测系统
常规风险
- API 密钥泄露：
POLY_API_KEY需妥善保管，避免硬编码至版本控制 - 配额超限成本：未合理设置请求频率可能导致意外账单
- 数据延迟风险：不同订阅等级数据实时性差异显著，生产环境需确认 SLA
- 服务连续性：依赖 Polygon/Massive 第三方服务，建议实现降级与缓存策略