加密货币逐笔成交 · REST 接口

加密货币逐笔成交。获取指定加密标的在给定时间范围内的逐笔成交数据，每条记录包含价格、数量、交易所、成交条件与精确时间戳。逐笔数据是构建聚合 K 线与深入分析的基础，可据此研究盘中价格变化、验证与优化算法策略，并保留可审计的市场活动记录。

GET /v3/trades/{cryptoTicker}

上游时效说明

实时

上游历史范围

数据可追溯至 2013 年 11 月 1 日

适用场景

盘中分析、算法交易、市场微观结构研究、数据完整性与合规。

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

查询参数

参数	类型	必填	说明
`cryptoTicker`	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[].conditions`	array[integer]	成交条件代码列表。
`results[].exchange`	integer	交易所 ID，映射关系可查阅「交易所名录」。
`results[].id`	string	成交 ID，在成交发生的交易所内唯一标识该笔成交。
`results[].participant_timestamp`	integer	交易所 Unix 时间戳（纳秒精度），即该笔成交在交易所生成的时间。
`results[].price`	number	该笔成交的价格，以加密货币交易对的基础货币表示。
`results[].received_timestamp`	integer	Massive 收到该笔行情数据的时间戳（纳秒精度）。
`results[].size`	number	成交规模（即成交量）。
`status`	string	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.massive.com/v3/trades/X:BTC-USD?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
  "request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
  "results": [
    {
      "conditions": [
        1
      ],
      "exchange": 1,
      "id": "191450340",
      "participant_timestamp": 1625097600103000000,
      "price": 35060,
      "received_timestamp": 1625097600125000000,
      "size": 1.0434526
    },
    {
      "conditions": [
        2
      ],
      "exchange": 1,
      "id": "191450341",
      "participant_timestamp": 1625097600368000000,
      "price": 35059.99,
      "received_timestamp": 1625097600390000000,
      "size": 0.0058883
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

加密货币 逐笔成交 · REST 接口

适用场景

查询参数

响应字段

响应示例

加密货币逐笔成交 · REST 接口