跳到主要内容

聚合交易查询

描述​

获取指定交易对的压缩聚合历史成交数据，适用于查询近期成交记录。

HTTP Request​

GET /bapi/defi/v1/public/alpha-trade/agg-trades

完整URL示例​

https://www.binance.com/bapi/defi/v1/public/alpha-trade/agg-trades?symbol=ALPHA_118USDC

参数​

名称类型是否必填描述
symbolSTRING是例如 "ALPHA_118USDC"，需使用Token列表中的代币ID
fromIdLONG否起始成交ID
startTimeLONG否起始时间戳（毫秒）
endTimeLONG否结束时间戳（毫秒）
limitINT否返回结果数量（默认500，最大1000）

响应结构​

对象数组，每个对象代表一条聚合成交：

  • a: 整数，聚合成交ID
  • p: 字符串，价格
  • q: 字符串，数量
  • f: 整数，首笔成交ID
  • l: 整数，末笔成交ID
  • T: 整数，时间戳
  • m: 布尔值（买方是否是做市商），该字段已废弃，可忽略

响应示例​

{
    "code": "000000",
    "message": "",
    "messageDetail": "",
    "data": [
        {
            "a": 58470,
            "p": "1.00",
            "q": "1.00",
            "f": 58470,
            "l": 58665,
            "T": 1752568680000,
            "m": true
        }
    ]
}