BIbinance
Margin

Get Interest History (USER_DATA)

Changed on
  • 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

Request

  • Base URL
    https://api.binance.com
  • URL
    https://api.binance.com/sapi/v1/margin/interestHistory
  • Auth
    API key in header X-MBX-APIKEY

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

  • a484ce871a72Revision changes
    • breaking

      for the query request parameter current, the type changed from number to integer, and format from no format to int32

    • breaking

      for the query request parameter endTime, the format changed from no format to int64

    • breaking

      for the query request parameter recvWindow, the format changed from no format to int64

    • breaking

      for the query request parameter size, the format changed from no format to int32

    • breaking

      for the query request parameter startTime, the format changed from no format to int64

    • breaking

      for the query request parameter timestamp, the format changed from no format to int64

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property became required for the status