get
https://api-pro.sim.hashkeydev.com/api/v1/account/tradesByClOrderId
Query account history and transaction records by clientOrderId. Support 30-day data.
- 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. Default 500, max 500 | |
| 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 trade time (traded but not yet settled) 撮合成交时间 |
| 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 |