外汇 REST 接口概览
通过REST 接口使用外汇数据。REST 通道用于按需查询历史行情、快照与参考数据，路径与参数与官方文档一致，便于把已有代码直接改指向本站。适合回测取数、批量补数与后台任务。
聚合 K 线
自定义 K 线（OHLC）Custom Bars (OHLC)
外汇自定义 K 线聚合。按自定义日期范围与时间粒度（美东时区）获取指定外汇货币对的聚合开盘价、最高价、最低价、收盘价与成交量数据。与股票、期权不同，外汇聚合基于买卖报价而非成交生成；某时间窗内若无新报价，则不产生 K 线。可通过 multiplier 与 timespan 参数调整粒度，例如 5 分钟 K 线。
GET /v2/aggs/ticker/{forexTicker}/range/{multiplier}/{timespan}/{from}/{to}查看参数、字段和示例 →每日市场汇总（OHLC）Daily Market Summary (OHLC)
外汇全市场日线汇总。获取指定交易日全部外汇标的的日频开盘价、最高价、最低价、收盘价、成交量与成交量加权平均价（VWAP）。一次请求即可完成全市场覆盖。
GET /v2/aggs/grouped/locale/global/market/fx/{date}查看参数、字段和示例 →前一日 K 线（OHLC）Previous Day Bar (OHLC)
外汇前一日 K 线。获取指定货币对前一交易日的开盘价、最高价、最低价、收盘价与成交量数据，用于评估近期表现并辅助交易决策。
GET /v2/aggs/ticker/{forexTicker}/prev查看参数、字段和示例 →接口
市场运行
交易所名录Exchanges
获取已知交易所清单，包括其标识、名称、市场类型及其他相关属性，可用于映射交易所代码、了解市场覆盖范围并将交易所信息集成到自己的应用中。
GET /v3/reference/exchanges查看参数、字段和示例 →市场休市安排Market Holidays
获取即将到来的市场休市安排及其对应的开市、收市时间。该接口仅提供前瞻性数据，列出会影响市场交易时段的未来休市日，可用于提前规划交易活动与系统运维窗口。
GET /v1/marketstatus/upcoming查看参数、字段和示例 →市场状态Market Status
获取各交易所及整体金融市场当前的交易状态，实时指示市场处于开市、休市还是盘前、盘后时段，并附带当前或下一交易时段的起止时间。
GET /v1/marketstatus/now查看参数、字段和示例 →报价数据
行情快照
全市场快照Full Market Snapshot
外汇全市场快照。一次响应返回外汇市场的完整快照，汇总价格、成交量与报价活动等信息，无需多次查询。快照数据每日美东时间 0:00 清空，随后随交易所上报新数据逐步回填，最早可能从 4:00 开始。
GET /v2/snapshot/locale/global/markets/forex/tickers查看参数、字段和示例 →单标的快照Single Ticker Snapshot
单标的外汇快照。汇总指定标的最新报价以及分钟、日线、前一日等聚合数据，便于紧盯单个标的的实时动态。快照数据于美东时间 0:00 清空，并随交易所上报逐步更新。
GET /v2/snapshot/locale/global/markets/forex/tickers/{ticker}查看参数、字段和示例 →市场涨跌榜Top Market Movers
外汇涨跌幅榜。给出外汇市场涨幅或跌幅最大的 20 个标的：涨幅榜按相对前收盘涨幅最大排序，跌幅榜反之。快照数据每日美东时间 0:00 清空并随交易所上报逐步回填。
GET /v2/snapshot/locale/global/markets/forex/{direction}查看参数、字段和示例 →统一快照Unified Snapshot
一次请求即可获取股票、期权、外汇、加密货币等多资产类别的统一行情快照，涵盖最新成交、最新报价以及开盘价、最高价、最低价、收盘价与成交量等关键指标，可一览当前市场全貌。该接口把各来源数据聚合到一次响应中，便于高效监控、比较并据此操作跨市场、跨资产类别的信息。
GET /v3/snapshot查看参数、字段和示例 →技术指标
指数移动平均（EMA）Exponential Moving Average (EMA)
获取指定标的在给定时间范围内的指数移动平均（EMA）。EMA 对近期价格赋予更高权重，因此能更快识别趋势并给出更灵敏的信号。
GET /v1/indicators/ema/{fxTicker}查看参数、字段和示例 →平滑异同移动平均（MACD）Moving Average Convergence/Divergence (MACD)
获取指定标的在给定时间范围内的平滑异同移动平均（MACD）。MACD 是由两条移动平均线推导而来的动量指标，可用于判断趋势强度、方向以及潜在买卖信号。
GET /v1/indicators/macd/{fxTicker}查看参数、字段和示例 →相对强弱指标（RSI）Relative Strength Index (RSI)
获取指定标的在给定时间范围内的相对强弱指标（RSI）。RSI 衡量价格变化的速度与幅度，在 0 到 100 之间波动，用于识别超买或超卖状态。
GET /v1/indicators/rsi/{fxTicker}查看参数、字段和示例 →简单移动平均（SMA）Simple Moving Average (SMA)
获取指定标的在给定时间范围内的简单移动平均（SMA）。SMA 按设定的周期数计算平均价格，平滑价格波动以揭示潜在趋势与信号。
GET /v1/indicators/sma/{fxTicker}查看参数、字段和示例 →标的资料
全部标的代码All Tickers
获取 Massive 上游支持的全部标的代码清单，覆盖股票、指数、外汇、加密货币等多个资产类别。每个条目给出代码、名称、市场、币种与是否仍在交易等关键信息。
GET /v3/reference/tickers查看参数、字段和示例 →标的概览Ticker Overview
单标的外汇详情。获取指定标的（截至某日期仍处于交易状态）的完整资料，包括主交易所、标准化标识（CIK、综合 FIGI、股份类别 FIGI）、市值、行业分类与关键日期，并提供 Logo、图标等品牌素材。若需查询已退市标的，请在「全部标的」接口中使用 active=false。
GET /v3/reference/tickers/{ticker}查看参数、字段和示例 →使用前注意
- 核对标的代码、时间范围、复权方式与分页。
- 保留接口路径中的版本号；不要统一加上额外的 /v1 前缀。