外汇报价 · REST 接口

外汇历史最优买卖报价（BBO）。获取指定货币对在给定时间范围内的历史 BBO 报价，每条记录包含买卖价、交易所标识与时间戳，反映各时刻的一档报价情况。可用于分析汇率走势、评估市场流动性并优化外汇交易或研究策略。

GET /v3/quotes/{fxTicker}

上游时效说明

实时

上游历史范围

数据可追溯至 2009 年 9 月 25 日

适用场景

历史报价分析、流动性评估、算法回测、策略优化。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`fxTicker`	string	Yes	要获取报价的标的代码。
`timestamp`	string	No	按时间戳查询。可传 YYYY-MM-DD 格式的日期或纳秒时间戳。
`timestamp.gte`	string	No	按 timestamp 范围筛选。
`timestamp.gt`	string	No	按 timestamp 范围筛选。
`timestamp.lte`	string	No	按 timestamp 范围筛选。
`timestamp.lt`	string	No	按 timestamp 范围筛选。
`order`	string	No	按 sort 字段对结果排序。
`limit`	integer	No	限制返回结果数量，默认 1000，最大 50000。
`sort`	string	No	用于排序的字段。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	包含所请求数据的数组。
`results[].ask_exchange`	integer	卖价所属交易所的 ID。
`results[].ask_price`	number	卖价（ask）。
`results[].bid_exchange`	integer	买价所属交易所的 ID。
`results[].bid_price`	number	买价（bid）。
`results[].participant_timestamp`	integer	交易所 Unix 时间戳（纳秒精度），即该笔报价在交易所生成的时间。
`status`	string	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.massive.com/v3/quotes/C:EUR-USD?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
  "request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
  "results": [
    {
      "ask_exchange": 48,
      "ask_price": 1.18565,
      "bid_exchange": 48,
      "bid_price": 1.18558,
      "participant_timestamp": 1625097600000000000
    },
    {
      "ask_exchange": 48,
      "ask_price": 1.18565,
      "bid_exchange": 48,
      "bid_price": 1.18559,
      "participant_timestamp": 1625097600000000000
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

外汇 报价 · REST 接口

适用场景

查询参数

响应字段

响应示例

外汇报价 · REST 接口