Get borrowing rate & limits

GET

https://www.okx.com/api/v5/account/interest-limits

GET

/api/v5/account/interest-limits

curl https://www.okx.com/api/v5/account/interest-limits \
     -H "OK-ACCESS-KEY: <apiKey>"

200account_getInterestLimits_example

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "debt": "0.85893159114900247077000000000000",
      "interest": "0.00000000000000000000000000000000",
      "nextDiscountTime": "1729490400000",
      "nextInterestTime": "1729490400000",
      "loanAlloc": "",
      "records": [
        {
          "ccy": "BTC",
          "rate": "0.0000276",
          "loanQuota": "175.00000000",
          "surplusLmt": "175.00000000",
          "usedLmt": "0.00000000",
          "interest": "0",
          "posLoan": "",
          "availLoan": "",
          "usedLoan": "",
          "avgRate": "",
          "interestFreeLiab": "",
          "potentialBorrowingAmt": "",
          "surplusLmtDetails": {}
        }
      ]
    }
  ]
}

Retrieve the borrowing rate and quota limits for VIP or regular loans by currency.

Authentication

OK-ACCESS-KEYstring

Your API key.

OK-ACCESS-SIGNstring

Base64-encoded HMAC-SHA256 signature of the prehash string.

OK-ACCESS-TIMESTAMPstring

ISO 8601 UTC timestamp, e.g. 2020-12-08T09:08:57.715Z.

OK-ACCESS-PASSPHRASEstring

The passphrase you set when creating the API key.

Query parameters

typeenumOptional

Loan type: 1 VIP loans, 2 Market loans.

Allowed values:

ccystringOptional

Loan currency, e.g. BTC.

Response

Successful response

codestringOptional

Result code. 0 means success; any other value is an error code.

msgstringOptional

Error message. Empty on success.

datalist of objectsOptional

Get borrowing rate & limits

Authentication

Query parameters

Response

More about OKX

Products

Services

Support

Buy crypto

Crypto calculator

Trade

Trade on the go with OKX