跳到主要内容

近期成交(归集)

接口描述​

归集交易与逐笔交易的区别在于，同一价格、同一方向、同一时间(100ms 计算)的订单簿trade 会被聚合为一条

HTTP请求​

GET /dapi/v1/aggTrades

请求权重​

20

请求参数​

名称类型是否必需描述
symbolSTRINGYES交易对
fromIdLONGNO从包含 fromID 的成交开始返回结果
startTimeLONGNO从该时刻之后的成交记录开始返回结果
endTimeLONGNO返回该时刻为止的成交记录
limitINTNO默认 500; 最大 1000.
  • 接口仅支持查询最近1年的交易数据
  • 如果同时发送startTime和endTime，间隔必须小于一小时
  • 如果没有发送任何筛选参数(fromId, startTime, endTime),默认返回最近的成交记录
  • 保险基金和自动减仓(ADL)成交不属于订单簿成交，故不会被归并聚合
  • 同时发送startTime/endTime和fromId可能导致请求超时，建议仅发送fromId或仅发送startTime和endTime

响应示例​

[
  {
    a: 416690, // 归集成交ID
    p: "9642.4", // 成交价
    q: "3", // 成交量
    f: 595259, // 被归集的首个成交ID
    l: 595259, // 被归集的末个成交ID
    T: 1591250548649, // 成交时间
    m: true, // 是否为主动卖出单
  }
]