Massive 用于通过其 REST API 获取市场参考数据、历史 K 线(bars)、快照和交易日历信息。官方文档:https://massive.com/docs/rest/quickstart。适用场景包括:查询股票、外汇、加密货币、期权、期货或指数代码;获取 OHLC 数据、上一交易日收盘、市场快照或市场状态;为金融工作流补充 Massive 市场参考数据。
使用前提:需要在 app.vm0.ai/connectors 连接 Massive 连接器。若请求失败,可运行 zero doctor check-connector --env-name MASSIVE_TOKEN,或 zero doctor check-connector --url "https://api.massive.com/v3/reference/tickers?market=stocks&limit=1" --method GET 排查。
常见用法:列出活跃股票代码,GET /v3/reference/tickers?market=stocks&active=true&limit=10;查询单个代码概览,GET /v3/reference/tickers/<ticker>;获取上一交易日 OHLC,GET /v2/aggs/ticker/<ticker>/prev?adjusted=true;获取历史日线 K 线,GET /v2/aggs/ticker/<ticker>/range/1/day/<from-date>/<to-date>?adjusted=true&sort=asc&limit=120(日期用 YYYY-MM-DD);获取每日市场汇总,GET /v2/aggs/grouped/locale/us/market/stocks/<date>?adjusted=true&include_otc=false;获取外汇上一交易日 OHLC,GET /v2/aggs/ticker/<forex-ticker>/prev?adjusted=true;检查市场状态,GET /v1/marketstatus/now。
指南与限制:认证优先使用 Authorization: Bearer $MASSIVE_TOKEN,也支持 apiKey 查询参数,但用请求头可避免密钥出现在 URL 中。不同资产类别的代码格式不同,股票如 AAPL,外汇常用 C:EURUSD,加密货币常用 X:BTCUSD。免费与付费套餐在数据时效性、历史深度和支持资产类别上有差异,各端点页面会标注套餐访问权限。部分端点会返回 next_url,需携带相同 Authorization 头继续分页。端点具体计划限制以官方文档为准。