Aggregated Trades
Endpoint: /bapi/defi/v1/public/alpha-trade/agg-trades
Full URL Example
https://www.binance.com/bapi/defi/v1/public/alpha-trade/agg-trades?symbol=ALPHA_118USDC
Description
Retrieves compressed, aggregated historical trades for a specific symbol. Useful for recent trade history.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| symbol | STRING | YES | e.g., "ALPHA_118USDC" – use token ID from Token List |
| fromId | LONG | NO | starting trade ID to fetch from |
| startTime | LONG | NO | start timestamp (milliseconds) |
| endTime | LONG | NO | end timestamp (milliseconds) |
| limit | INT | NO | number of results to return (default 500, max 1000) |
Response Structure
Array of objects, each representing an aggregated trade:
a: Integer (aggregate trade ID)p: String (price)q: String (quantity)f: Integer (first trade ID)l: Integer (last trade ID)T: Integer (timestamp)m: Boolean (true if buyer is market maker) ← deprecated field, can ignore