Wallet

Daily Account Snapshot (USER_DATA)

The query time period must be less than 30 days
Support query within the last one month only
If startTimeand endTime not sent, return records of the last 7 days by default

Weight(IP): 2400

get/sapi/v1/accountSnapshot

Query parameters

type'SPOT' | 'MARGIN' | 'FUTURES' required

startTimeinteger

UTC timestamp in ms

endTimeinteger

UTC timestamp in ms

limitinteger

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Account Snapshot

Example response

{
  "code": 200,
  "snapshotVos": [
    {
      "data": {
        "balances": [
          {
            "asset": "BTC",
            "free": "0.2",
            "locked": "0.001"
          }
        ],
        "totalAssetOfBtc": "0.09905021"
      },
      "type": "spot",
      "updateTime": 1576281599000
    }
  ]
}

Changes

Changed in 2 of the 26 revisions of this API.748

Feb 17, 20229f8e6c752c152See the full diff
- ▲
  for the query request parameter limit, default value was changed from 5 to 7
  request-parameter-default-value-changed
- ▲
  for the query request parameter limit, the min was increased from 5.00 to 7.00
  request-parameter-min-increased
Oct 25, 2021a484ce871a72548See the full diff
- ▲
  for the query request parameter endTime, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter limit, the type/format was changed from integer/ to integer/int32
  request-parameter-type-changed
- ▲
  for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter startTime, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property code became required for the status 401
  response-property-became-required
- ○
  the response property msg became required for the status 400
  response-property-became-required
- ○
  the response property msg became required for the status 401
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/code became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/msg became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/assets became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/assets/items/asset became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/assets/items/marginBalance became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/assets/items/walletBalance became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/position became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/position/items/entryPrice became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/position/items/markPrice became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/position/items/positionAmt became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/position/items/symbol became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/data/position/items/unRealizedProfit became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/type became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotFutures]/snapshotVos/items/updateTime became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/code became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/msg became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/marginLevel became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/totalAssetOfBtc became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/totalLiabilityOfBtc became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/totalNetAssetOfBtc became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/userAssets became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/userAssets/items/asset became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/userAssets/items/borrowed became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/userAssets/items/free became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/userAssets/items/interest became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/userAssets/items/locked became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/data/userAssets/items/netAsset became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/type became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotMargin]/snapshotVos/items/updateTime became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/code became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/msg became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/data became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/data/balances became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/data/balances/items/asset became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/data/balances/items/free became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/data/balances/items/locked became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/data/totalAssetOfBtc became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/type became required for the status 200
  response-property-became-required
- ○
  the response property oneOf[snapshotSpot]/snapshotVos/items/updateTime became required for the status 200
  response-property-became-required

Full history