聚合交易查询

描述

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

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

参数

名称	类型	是否必填	描述
symbol	STRING	是	例如 "ALPHA_118USDC"，需使用Token列表中的代币ID
fromId	LONG	否	起始成交ID
startTime	LONG	否	起始时间戳（毫秒）
endTime	LONG	否	结束时间戳（毫秒）
limit	INT	否	返回结果数量（默认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
        }
    ]
}