美股逐笔成交 · REST 接口

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

GET /v3/trades/{stockTicker}

上游时效说明

盘后、延迟 15 分钟或实时

上游历史范围

数据可追溯至 2003 年 9 月 10 日

适用场景

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

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

查询参数

参数	类型	必填	说明
`stockTicker`	string	Yes	指定区分大小写的标的代码。例如 AAPL 代表苹果公司。
`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[].correction`	integer	成交修正标识。
`results[].decimal_size`	string	含碎股部分的成交规模，以小数形式的字符串表示。
`results[].exchange`	integer	交易所 ID，映射关系可查阅「交易所名录」。
`results[].id`	string	唯一标识一笔成交的成交 ID。它在「标的 + 交易所 + TRF」组合内唯一。例如 AAPL 在 NYSE 与在 NASDAQ 的两笔成交，可能拥有相同的成交 ID。
`results[].participant_timestamp`	integer	参与者或交易所的纳秒级 Unix 时间戳，即该成交在交易所实际生成的时间。
`results[].price`	number	成交价，即每整股的实际美元价格。例如以 $2.00 成交 100 股，总金额为 $200.00。
`results[].sequence_number`	integer	序号表示成交事件发生的先后顺序。这些序号在每个标的代码内递增且唯一，但并不总是连续（例如 1、2、6、9、10、11）。每个交易时段或每日结束时归零。
`results[].sip_timestamp`	integer	SIP 的纳秒级 Unix 时间戳，即 SIP 从产生该成交的交易所收到它的时间。
`results[].size`	number	成交规模（即成交量）。
`results[].tape`	integer	共有 3 个「带」（tape），用于区分标的的上市交易所。接口中以代表字母序号的整数表示，例如 1 = A、2 = B、3 = C。带 A 为 NYSE 上市证券，带 B 为 NYSE ARCA 与 NYSE American，带 C 为 NASDAQ。
`results[].trf_id`	integer	该笔成交所在交易报告设施（TRF）的 ID。
`results[].trf_timestamp`	integer	TRF（交易报告设施）的纳秒精度 Unix 时间戳，即交易报告设施收到该成交的时间。
`status`	string	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.massive.com/v3/trades/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
  "request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
  "results": [
    {
      "conditions": [
        12,
        41
      ],
      "decimal_size": "100.0",
      "exchange": 11,
      "id": "1",
      "participant_timestamp": 1517562000015577000,
      "price": 171.55,
      "sequence_number": 1063,
      "sip_timestamp": 1517562000016036600,
      "size": 100,
      "tape": 3
    },
    {
      "conditions": [
        12,
        41
      ],
      "decimal_size": "100.0",
      "exchange": 11,
      "id": "2",
      "participant_timestamp": 1517562000015577600,
      "price": 171.55,
      "sequence_number": 1064,
      "sip_timestamp": 1517562000016038100,
      "size": 100,
      "tape": 3
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

美股 逐笔成交 · REST 接口

适用场景

查询参数

响应字段

响应示例

美股逐笔成交 · REST 接口