Margin

Get Interest History (USER_DATA)

Response in descending order
If isolatedSymbol is not sent, crossed margin data will be returned
Set archived to true to query data from 6 months ago
type in response has 4 enums:
- PERIODIC interest charged per hour
- ON_BORROW first interest charged on borrow
- PERIODIC_CONVERTED interest charged per hour converted into BNB
- ON_BORROW_CONVERTED first interest charged on borrow converted into BNB

Weight(IP): 1

get/sapi/v1/margin/interestHistory

Query parameters

assetstring

Example:BNB

isolatedSymbolstring

Isolated symbol

startTimeinteger

UTC timestamp in ms

endTimeinteger

UTC timestamp in ms

currentinteger

Example:1

Current querying page. Start from 1. Default:1

sizeinteger

Example:100

Default:10 Max:100

archivedstring

Default: false. Set to true for archived data from 6 months ago

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Interest History, response in descending order

totalinteger required

Example response

{
  "rows": [
    {
      "isolatedSymbol": "BNBUSDT",
      "asset": "BNB",
      "interest": "0.01866667",
      "interestAccuredTime": 1566813600,
      "interestRate": "0.01600000",
      "principal": "36.22000000",
      "type": "ON_BORROW"
    }
  ],
  "total": 1
}

Changes

Changed in 1 of the 26 revisions of this API.613

Oct 25, 2021a484ce871a72613See the full diff
- ▲
  for the query request parameter current, the type/format was changed from number/ to integer/int32
  request-parameter-type-changed
- ▲
  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 recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter size, the type/format was changed from integer/ to integer/int32
  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 rows became required for the status 200
  response-property-became-required
- ○
  the response property rows/items/asset became required for the status 200
  response-property-became-required
- ○
  the response property rows/items/interest became required for the status 200
  response-property-became-required
- ○
  the response property rows/items/interestAccuredTime became required for the status 200
  response-property-became-required
- ○
  the response property rows/items/interestRate became required for the status 200
  response-property-became-required
- ○
  the response property rows/items/isolatedSymbol became required for the status 200
  response-property-became-required
- ○
  the response property rows/items/principal became required for the status 200
  response-property-became-required
- ○
  the response property rows/items/type became required for the status 200
  response-property-became-required
- ○
  the response property total became required for the status 200
  response-property-became-required

Full history