跳到主要内容

近期成交(归集)

接口描述​

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

HTTP请求​

GET /fapi/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": 26129,         // 归集成交ID
    "p": "0.01633102",  // 成交价
    "q": "4.70443515",  // 成交量
    "f": 27781,         // 被归集的首个成交ID
    "l": 27781,         // 被归集的末个成交ID
    "T": 1498793709153, // 成交时间
    "m": true,          // 是否为主动卖出单
  }
]