Query account history and transaction records
- If there is only fromId, It will return trades with IDs bigger than fromId, sorted in descending order.
- If there is only toId. It will return trades with IDs less than toId, sorted in descending order
- If both fromId and toId are provided. It will return trades between fromId and toId, sorted in descending order
- If neither fromId or toId is provided, it will return the latest trade records, sorted in descending order.
Weight: 5
Request Parameters
| PARAMETER | TYPE | Req'd | DESCRIPTION |
|---|---|---|---|
| symbol | STRING | Trading pair | |
| startTime | LONG | Start Timestamp | |
| endTime | LONG | End Timestamp. Only supports the last 30 days timeframe | |
| clientOrderId | STRING | Client Order ID | |
| fromId | LONG | Starting ID | |
| toId | LONG | End ID | |
| limit | INT | Limit of record | |
| accountId | LONG | Account ID | |
| timestamp | LONG | Y | Timestamp |
Response Content
PARAMETER | TYPE | Example values | DESCRIPTION |
|---|---|---|---|
Object Array | Check transaction results | ||
id | STRING | 1470930841345474561 | Unique transaction ID (This value is the trade_id in v0 API) |
clientOrderId | STRING | 999999999800021 | An ID defined by the client for the order, it will be automatically generated if it is not sent in the request |
ticketId | STRING | 1478144171272585249 | Execution ID, the execution ID is the same for the direction of a single trade. |
symbol | STRING | BTCUSD | Trading pair |
symbolName | STRING | BTCUSD | Trading pair name |
orderId | STRING | 1470930841211329280 | Order ID |
matchOrderId | STRING | 1470930605684362240 | //Ignore |
price | STRING (decimal) | 29851.03 | Price |
qty | STRING (decimal) | 0.0005 | Quantity |
commission | STRING (decimal) | 0.02985103 | Commission fee |
commissionAsset | STRING | USD | Currency of commission fee |
time | STRING (decimal) | 1690084620567 | Millisecond Timestamp |
isBuyer | BOOLEAN | false | Whether the trade is a buyer |
isMaker | BOOLEAN | false | Whether the trade is a maker |
fee | Object | Fee information | |
fee.feeCoinId | STRING | USD | Fee currency |
fee.feeCoinName | STRING | USD | Fee currency name |
fee.fee | STRING (decimal) | 0.02985103 | Transaction fee amount after HSK deduction |
fee.originFee | STRING (decimal) | 0.03085103 | The commission fee before HSK deduction. |
fee.originCoinId | STRING | USD | The commission fee before HSK deduction |
fee.originCoinName | STRING | USD | The commission fee coin |
feeCoinId | STRING | USD | Fee currency |
feeAmount | STRING (decimal) | 0.02985103 | Amount of transaction fee |
feeSupplementaryAmount | STRING | 0.00000634 | Supplementary commission fee to meet minimum commission fee requirement |
makerRebate | STRING | 0 | Return |
accountId | STRING | 1545583349011201280 | Account ID |
hskDeduct | BOOLEAN | true | true: successfully deducted HSK false |
hskDeductPrice | String | 0.001 | commission Coin price / HSK price |