Skip to main content

Daily Account Snapshot (USER_DATA)

API Description

Daily account snapshot

HTTP Request

GET /sapi/v1/accountSnapshot

Request Weight(IP)

2400

Request Parameters

NameTypeMandatoryDescription
typeSTRINGYES"SPOT", "MARGIN", "FUTURES"
startTimeLONGNO
endTimeLONGNO
limitINTNOmin 7, max 30, default 7
recvWindowLONGNO
timestampLONGYES
  • The query time period must be less then 30 days
  • Support query within the last one month only
  • If startTimeand endTime not sent, return records of the last 7 days by default

Response Example

{
"code": 200, // 200 for success; others are error codes
"msg": "", // error message
"snapshotVos": [
{
"data": {
"balances": [
{
"asset": "BTC",
"free": "0.09905021",
"locked": "0.00000000"
},
{
"asset": "USDT",
"free": "1.89109409",
"locked": "0.00000000"
}
],
"totalAssetOfBtc": "0.09942700"
},
"type": "spot",
"updateTime": 1576281599000
}
]
}

OR

{
"code": 200, // 200 for success; others are error codes
"msg": "", // error message
"snapshotVos": [
{
"data": {
"marginLevel": "2748.02909813",
"totalAssetOfBtc": "0.00274803",
"totalLiabilityOfBtc": "0.00000100",
"totalNetAssetOfBtc": "0.00274750",
"userAssets": [
{
"asset": "XRP",
"borrowed": "0.00000000",
"free": "1.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "1.00000000"
}
]
},
"type": "margin",
"updateTime": 1576281599000
}
]
}

OR

{
"code": 200, // 200 for success; others are error codes
"msg": "", // error message
"snapshotVos": [
{
"data": {
"assets": [
{
"asset": "USDT",
"marginBalance": "118.99782335", // Not real-time data, can ignore
"walletBalance": "120.23811389"
}
],
"position": [
{
"entryPrice": "7130.41000000",
"markPrice": "7257.66239673",
"positionAmt": "0.01000000",
"symbol": "BTCUSDT",
"unRealizedProfit": "1.24029054" // Only show the value at the time of opening the position
}
]
},
"type": "futures",
"updateTime": 1576281599000
}
]
}