get https://api-pro.sim.hashkeydev.com/api/v1/account/balanceFlow
- Only master account Master API key can call this interface, sub-accounts will return insufficient privilege type error code
- All orders returned are final
- Deposit, Withdrawal failed will not be returned
- Query of trade history supports the past 14 days time range(though the endpoint support up to get 7 days data for each request). The other types support maximum 30 days. Exceeded amount will return error code "Exceed maximum time range of N days"
- Remark can only support up to 128 characters
NotePlease note the current endpoint is available to our Institutional clients only and can be requested by case by case
Weight: 3
Request Parameters
| PARAMETER | TYPE | Req'd | DESCRIPTION |
|---|---|---|---|
| accountId | LONG | Account ID | |
| type | STRING | Y | Transaction type: "trade" "deposit" "fiatDeposit" "withdraw" "fiatWithdraw" "transfer" "reversal" "refund" |
| clientOrderId | STRING | Corresponds to types: "trade", "withdraw", "fiatWithdraw", "transfer" | |
| remark | STRING | Remark | |
| startTime | LONG | Y | Start timestamp ** timestamp 是结算开始时间 |
| endTime | LONG | Y | End timestamp ** timestamp 是结算开始时间 |
| beginId | INT | Start record number. Default: 0 E.g. If input ID is 1, return starting ID as 2 | |
| limit | INT | Limit | |
| recvWindow | LONG | Recv window | |
| timestamp | LONG | Y | Timestamp |
Type = trade
Supported for the past 7 days time range
Response content
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
| id | STRING | Record ID |
| accountId | STRING | Account ID |
| type | STRING | "trade" |
| netBaseAmount | STRING | Order Quantity Default Value ="" Buy direction (+ve) Sell direction (-ve) |
| baseCcy | STRING | Base currency |
| baseAssetBalance | STRING | Base asset balance Default Value ="" |
| netQuoteAmount | STRING | Price * Quantity Default Value ="" Buy direction (-ve) Sell direction (+ve) |
| quoteAssetBalance | STRING | Quote asset balance Default Value ="" |
| quoteCcy | STRING | E.g. USDT, USDC, USD |
| direction | STRING | BUY or SELL |
| fee | STRING | Trading fee Default Value = 0 |
| feeSupplementaryAmount | STRING | Supplementary commission fee to meet minimum commission fee requirement |
| feeCcy | STRING | E.g. BTC, ETH, USDC |
| clientOrderId | STRING | Client order ID |
| orderId | STRING | Order ID |
| tradeId | STRING | Trade ID |
| transactTime | STRING | Trade completed and settled time 结算完成时间 |
Sample
[
{
"id": "47049",
"accountId": "1617382306753847296",
"type": "trade",
"netBaseAmount": "0.00015",
"baseCcy": "BTC",
"baseAssetBalance": "96.53346265",
"netQuoteAmount": "-9.622275",
"quoteCcy": "USDC",
"quoteAssetBalance": "887623.4732212",
"direction": "BUY",
"fee": "0.000000225",
"feeCcy": "BTC",
"clientOrderId": "99999999980097",
"orderId": "1733373323360866560",
"tradeId": "1733373323528638720",
"transactTime": "1721370202000" //Trade Completed time
},
{
"id": "47050",
"accountId": "1617382306753847296",
"type": "trade",
"netBaseAmount": "0.29951",
"baseCcy": "BTC",
"baseAssetBalance": "96.83297265",
"netQuoteAmount": "-9984.7019729",
"quoteCcy": "USD",
"quoteAssetBalance": "679.337974140649999999",
"direction": "BUY",
"fee": "14.97705295935",
"feeCcy": "USD",
"clientOrderId": "99999999980098",
"orderId": "1733374982912741632",
"tradeId": "1733374983021793536",
"transactTime": "1721370400000" //Trade Completed time
}
]Type = fiatDeposit/fiatWithdraw
Supported for the past 30 days time range
Response content
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
| id | STRING | Record ID |
| accountId | STRING | Account ID |
| type | STRING | "fiatDeposit", "fiatWithdraw" |
| netFiatAmount | STRING | Fiat Deposit/Withdraw: amount Default Value = 0 |
| fiatCcy | STRING | E.g. HKD, USD |
| fiatBalance | STRING | Fiat balance in the account Default Value = 0 |
| fee | STRING | Fee amount |
| feeCcy | STRING | Fee Currency |
| orderId | STRING | Fiat Order ID |
| remark | STRING | Remark |
| transactTime | STRING | Fiat Deposit/Withdraw Completed Time |
Sample
[
{
"id": "3",
"accountId": "1491920242963768578",
"type": "fiatDeposit",
"netFiatAmount": "100001",
"fiatCcy": "USD",
"fiatBalance": "897400",
"fee": "0",
"feeCcy": "USD",
"orderId": "FD486905037302665216",
"remark": "",
"transactTime": "1693895601000"
},
{
"id": "1",
"accountId": "1491920242963768578",
"type": "fiatWithdraw",
"netFiatAmount": "50001",
"fiatCcy": "USD",
"fiatBalance": "797399",
"fee": "0",
"feeCcy": "USD",
"orderId": "FW486905166923436032",
"remark": "",
"transactTime": "1693895424000"
}
]Type = deposit/withdraw/refund
Supported for the past 30 days time range
Response content
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
| id | STRING | Record ID |
| accountId | STRING | Account ID |
| type | STRING | "Deposit", "Withdraw", "Refund" |
| netVaAmount | STRING | Deposit/Withdraw: amount Default Value = 0 |
| vaCcy | STRING | ETH, BTC, USDC, etc |
| vaChainType | STRING | Tron |
| vaBalance | STRING | Fiat balance in the account Default Value = 0 |
| fee | STRING | Deposit/Withdraw Fee Default Value = 0 |
| feeCcy | STRING | Fee Currency |
| clientOrderId | STRING | The unique ID assigned by the client |
| orderId | STRING | Deposit/Withdraw Order ID |
| txnId | STRING | Chain Transaction ID |
| remark | STRING | Remark |
| transactTime | STRING | Deposit/Withdraw Completed Time |
Sample
[
{
"id": "720",
"accountId": "1978966613676937217",
"type": "Deposit",
"netVaAmount": "8989",
"vaCcy": "USDT",
"vaChainType": "Tron",
"vaBalance": "1030784.1498",
"fee": "0.0001",
"feeCcy": "USDT",
"orderId": "D768973742990266368",
"txnId": "",
"remark": "",
"transactTime": "1761145789691",
"clientOrderId": ""
},
{
"id": "343",
"accountId": "1954346749805043457",
"type": "Withdraw",
"netVaAmount": "180",
"vaCcy": "USDT",
"vaChainType": "Tron",
"vaBalance": "0",
"fee": "0",
"feeCcy": "USDT",
"orderId": "W769152094447452160",
"txnId": "3dafba8abd7a7b2d02ac9161b41313931c9bafa18cf8cec2c98b1a4ec300be32",
"remark": "",
"transactTime": "1761188210875",
"clientOrderId": "usdttron102303"
},
{
"id": "335",
"accountId": "1954346689088298753",
"type": "Refund",
"netVaAmount": "100.1199",
"vaCcy": "USDT",
"vaChainType": "Tron",
"vaBalance": "200.2697",
"fee": "0.0001",
"feeCcy": "USDT",
"orderId": "refund_D768944634495336448",
"txnId": "",
"remark": "",
"transactTime": "1761139348000",
"clientOrderId": ""
}
]Type = transfer
Supported for the past 30 days time range
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
| id | STRING | Record ID |
| fromAccountId | STRING | From Account ID |
| toAccountId | STRING | To Account ID |
| type | STRING | "transfer" |
| netTransferAmount | STRING | Transfer Amount Default Value = 0 |
| transferCcy | STRING | ETH, BTC, USDC, etc |
| fromAccountBalance | STRING | From Account balance Default Value = 0 |
| toAccountBalance | STRING | To Account balance Default Value = 0 |
| orderId | STRING | Transfer OrderID |
| remark | STRING | Remark |
| transactTime | STRING | Transfer Completed Time |
| clientOrderId | STRING | An ID defined by the client for the withdrawal order |
[
{
"id": "2286",
"fromAccountId": "1471090223379184385",
"toAccountId": "1471090223379184384",
"type": "transfer",
"netTransferAmount": "1",
"transferCcy": "BTC",
"fromAccountBalance": "1304.36501272",
"toAccountBalance": "6080.570119335",
"orderId": "1944297063069140480", // Transfer order ID
"remark": "",
"transactTime": "1746514272000",
"clientOrderId": ""
},
{
"id": "2287",
"fromAccountId": "1471090223379184385",
"toAccountId": "1471090223379184384",
"type": "transfer",
"netTransferAmount": "1",
"transferCcy": "BTC",
"fromAccountBalance": "1303.36501272",
"toAccountBalance": "6081.570119335",
"orderId": "1944304593916806656", // Transfer order ID
"remark": "",
"transactTime": "1746515169000",
"clientOrderId": ""
}
]