Borrow And Repay

Endpoint

Get future hourly interest rate

GET

/sapi/v1/margin/next-hourly-interest-rate

https://api.binance.com

Get future hourly interest rate › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get future hourly interest rate › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight100

Get future hourly interest rate › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get future hourly interest rate › Query Parameters

assets

string · required

List of assets, separated by commas, up to 20

Example: BTC,ETH

isIsolated

string · enum · required

for isolated margin or not

Enum values:

TRUE

FALSE

Example: TRUE

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Get future hourly interest rate › Responses

200

Get future hourly interest rate

object

asset

string

asset.

Example: BTC

nextHourlyInterestRate

string

next Hourly Interest Rate.

Example: 0.00000571

Get Interest History

GET

/sapi/v1/margin/interestHistory

https://api.binance.com

Get Interest History › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get Interest History › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Get Interest History › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get Interest History › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

asset

string

Example: USDT

isolatedSymbol

string

isolated symbol

Example: BNBUSDT

startTime

integer · int64

Only supports querying data from the past 90 days.

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

current

integer · int64 · min: 1

Currently querying page. Start from 1

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

The value cannot be greater than 60000

Example: 5000

Get Interest History › Responses

200

Get Interest History

object[]

rows list.

total

integer · int64

total.

Example: 1

Query borrow/repay records in Margin account

GET

/sapi/v1/margin/borrow-repay

https://api.binance.com

Query borrow/repay records in Margin account › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query borrow/repay records in Margin account › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight10

Query borrow/repay records in Margin account › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query borrow/repay records in Margin account › Query Parameters

type

string · enum · required

Enum values:

BORROW

REPAY

Example: BORROW

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

asset

string

Example: BNB

isolatedSymbol

string

Symbol in Isolated Margin

Example: BNBUSDT

txId

integer · int64

tranId in POST /sapi/v1/margin/loan

Example: 1

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

current

integer · int64 · min: 1

Currently querying page.

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Example: 5000

Query borrow/repay records in Margin account › Responses

200

borrow/repay records in Margin account

object[]

rows list.

total

integer · int64

total.

Example: 1

Margin account borrow/repay

POST

/sapi/v1/margin/borrow-repay

https://api.binance.com

Margin account borrow/repay › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Margin account borrow/repay › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1500

Margin account borrow/repay › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Margin account borrow/repay › Request Body

asset

string · required

Example: USDT

isIsolated

string · enum · required

TRUE for Isolated Margin, FALSE for Cross Margin

Enum values:

TRUE

FALSE

Example: TRUE

Default: FALSE

amount

string · required

Example: 1.0

type

string · enum · required

Enum values:

BORROW

REPAY

Example: BORROW

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

symbol

string

Only for Isolated margin

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin account borrow/repay › Responses

200

Margin account borrow/repay

tranId

integer · int64

tran Id.

Example: 100000001

Query Margin Interest Rate History

GET

/sapi/v1/margin/interestRateHistory

https://api.binance.com

Query Margin Interest Rate History › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Margin Interest Rate History › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Query Margin Interest Rate History › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query Margin Interest Rate History › Query Parameters

asset

string · required

Example: BTC

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

vipLevel

integer · int64

Default: user's vip level

Example: 1

startTime

integer · int64

Default: 7 days ago

Example: 1623319461670

endTime

integer · int64

Default: present. Maximum range: 1 months.

Example: 1641782889000

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Interest Rate History › Responses

200

Margin Interest Rate History

object

asset

string

asset.

Example: BTC

dailyInterestRate

string

daily Interest Rate.

Example: 0.00025000

timestamp

integer · int64

timestamp.

Example: 1611544731000

vipLevel

integer · int64

vip Level.

Example: 1

Query Max Borrow

GET

/sapi/v1/margin/maxBorrowable

https://api.binance.com

Query Max Borrow › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Max Borrow › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight50

Query Max Borrow › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query Max Borrow › Query Parameters

asset

string · required

Example: BTC

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

isolatedSymbol

string

isolated symbol

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Max Borrow › Responses

200

Max Borrow

amount

string

account's currently max borrowable amount with sufficient system availability

Example: 1.69248805

borrowLimit

string

max borrowable amount limited by the account level

Example: 60

Borrow And Repay

Endpoint

Download schema

Get future hourly interest rate

GET

/sapi/v1/margin/next-hourly-interest-rate

https://api.binance.com

Get future hourly interest rate › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get future hourly interest rate › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight100

Get future hourly interest rate › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get future hourly interest rate › Query Parameters

assets

string · required

List of assets, separated by commas, up to 20

Example: BTC,ETH

isIsolated

string · enum · required

for isolated margin or not

Enum values:

TRUE

FALSE

Example: TRUE

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Get future hourly interest rate › Responses

200

Get future hourly interest rate

object

asset

string

asset.

Example: BTC

nextHourlyInterestRate

string

next Hourly Interest Rate.

Example: 0.00000571

Get Interest History

GET

/sapi/v1/margin/interestHistory

https://api.binance.com

Get Interest History › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get Interest History › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Get Interest History › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get Interest History › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

asset

string

Example: USDT

isolatedSymbol

string

isolated symbol

Example: BNBUSDT

startTime

integer · int64

Only supports querying data from the past 90 days.

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

current

integer · int64 · min: 1

Currently querying page. Start from 1

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

The value cannot be greater than 60000

Example: 5000

Get Interest History › Responses

200

Get Interest History

object[]

rows list.

total

integer · int64

total.

Example: 1

Query borrow/repay records in Margin account

GET

/sapi/v1/margin/borrow-repay

https://api.binance.com

Query borrow/repay records in Margin account › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query borrow/repay records in Margin account › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight10

Query borrow/repay records in Margin account › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query borrow/repay records in Margin account › Query Parameters

type

string · enum · required

Enum values:

BORROW

REPAY

Example: BORROW

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

asset

string

Example: BNB

isolatedSymbol

string

Symbol in Isolated Margin

Example: BNBUSDT

txId

integer · int64

tranId in POST /sapi/v1/margin/loan

Example: 1

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

current

integer · int64 · min: 1

Currently querying page.

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Example: 5000

Query borrow/repay records in Margin account › Responses

200

borrow/repay records in Margin account

object[]

rows list.

total

integer · int64

total.

Example: 1

Margin account borrow/repay

POST

/sapi/v1/margin/borrow-repay

https://api.binance.com

Margin account borrow/repay › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Margin account borrow/repay › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1500

Margin account borrow/repay › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Margin account borrow/repay › Request Body

asset

string · required

Example: USDT

isIsolated

string · enum · required

TRUE for Isolated Margin, FALSE for Cross Margin

Enum values:

TRUE

FALSE

Example: TRUE

Default: FALSE

amount

string · required

Example: 1.0

type

string · enum · required

Enum values:

BORROW

REPAY

Example: BORROW

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

symbol

string

Only for Isolated margin

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin account borrow/repay › Responses

200

Margin account borrow/repay

tranId

integer · int64

tran Id.

Example: 100000001

Query Margin Interest Rate History

GET

/sapi/v1/margin/interestRateHistory

https://api.binance.com

Query Margin Interest Rate History › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Margin Interest Rate History › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Query Margin Interest Rate History › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query Margin Interest Rate History › Query Parameters

asset

string · required

Example: BTC

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

vipLevel

integer · int64

Default: user's vip level

Example: 1

startTime

integer · int64

Default: 7 days ago

Example: 1623319461670

endTime

integer · int64

Default: present. Maximum range: 1 months.

Example: 1641782889000

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Interest Rate History › Responses

200

Margin Interest Rate History

object

asset

string

asset.

Example: BTC

dailyInterestRate

string

daily Interest Rate.

Example: 0.00025000

timestamp

integer · int64

timestamp.

Example: 1611544731000

vipLevel

integer · int64

vip Level.

Example: 1

Query Max Borrow

GET

/sapi/v1/margin/maxBorrowable

https://api.binance.com

Query Max Borrow › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Max Borrow › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight50

Query Max Borrow › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query Max Borrow › Query Parameters

asset

string · required

Example: BTC

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

isolatedSymbol

string

isolated symbol

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Max Borrow › Responses

200

Max Borrow

amount

string

account's currently max borrowable amount with sufficient system availability

Example: 1.69248805

borrowLimit

string

max borrowable amount limited by the account level

Example: 60