The only difference between these two messages is that the snapshot contains balances of all currencies, while the incremental refresh contains only records about the changed balance. In both cases the balance record shows the current actual balance in the respective currency (and not its change). The difference is significant only for spot accounts that may have balances in several currencies.
Field name (REST) | Field tag (WS) |
| Possible values | Description |
msgType | 35 | M | XAR (Snapshot) XAF (Incremental refresh) |
|
account | 1 | M | ulong |
|
accountStatusRequestId | 42513 | C | string | Populated in case the snapshot is generated in response to the AccountStatusSnapshotRequest and the client provided the request ID |
lastUpdateTime | 779 | M | timestamp |
|
balances | 1800 | M | Array of Balance |
|
rejectReason | 380 | C | 4 — ApplicationNotAvailable 8 — ThrottleLimitExceeded | In case the balance cannot be loaded due to any error, Reject Reason will contain the description of the error. In this case the Balances array will be empty (independently on the real balance). |
text | 58 | C | string |
Balance
Field name (REST) | Field tag (WS) |
| Possible values | Description |
account | 1 | M | ulong |
|
currency | 15 | M | string |
|
lastUpdateTime | 779 | M | timestamp |
|
available | 1801 | M | decimal | Available for withdrawal or as free margin |
onHold | 1802 | M | decimal | Locked in orders, positions and withdrawal requests |
settled | 1803 | M | decimal | Balance |
equity | 1791 | M | decimal | Available+OnHold ammount
|
Samples
WS | REST |
{
"35":"XAR",
"1":1012838720,
"779":1597420573540429289,
"1800":[
{
"1":1012838720,
"15":"BTC",
"779":1597420573540429289,
"1801":"0.00009362",
"1802":"0.00001753",
"1803":"0.00011115",
"1791":"0.00011172",
"52313":"0"
}
]
}
| {
"msgType":"XAR",
"balances":[
{
"currency":"BTC",
"lastUpdateTime":1597420312192936650,
"available":"0.00009343",
"onHold":"0.00001772",
"settled":"0.00011115",
"equity":"0.00011154"
}
]
}
|