Trade

Endpoint

VIP Loan Borrow (TRADE)

VIP loan is available for VIP users only.

POST

/sapi/v1/loan/vip/borrow

https://api.binance.com

VIP Loan Borrow (TRADE) › 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

VIP Loan Borrow (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Borrow (TRADE) › 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

VIP Loan Borrow (TRADE) › Request Body

loanAccountId

integer · int64 · required

Example: 1

loanCoin

string · required

Example: BTC

loanAmount

number · float · required

Example: 1.0

collateralAccountId

string · required

Collateral account ID(s). Multiple split by ,

Example: 12345678,12345678,12345678

collateralCoin

string · required

Example: BUSD,USDT,ETH

isFlexibleRate

boolean · required

TRUE: flexible rate; FALSE: fixed rate

Example: true

Default: 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

loanTerm

integer · int64

Mandatory for fixed rate. Optional for flexible rate. e.g. 30/60 days

Example: 30

recvWindow

integer · int64 · max: 60000

Example: 5000

VIP Loan Borrow (TRADE) › Responses

200

VIP Loan Borrow

loanAccountId

string

Loan receiving account.

Example: 12345678

requestId

string

Example: 12345678

loanCoin

string

Example: BTC

isFlexibleRate

string

Example: Yes

loanAmount

string

Example: 100.55

collateralAccountId

string

Example: 12345678,12345678,12345678

collateralCoin

string

Example: BUSD,USDT,ETH

loanTerm

string

Example: 30

POST/sapi/v1/loan/vip/borrow

curl --request POST \
  --url https://api.binance.com/sapi/v1/loan/vip/borrow \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data loanAccountId=1 \
  --data loanCoin=BTC \
  --data loanAmount=1.0 \
  --data 'collateralAccountId=12345678,12345678,12345678' \
  --data 'collateralCoin=BUSD,USDT,ETH' \
  --data isFlexibleRate=true \
  --data timestamp=1770736694138

Example Request Body

{
  "loanAccountId": 1,
  "loanCoin": "BTC",
  "loanAmount": "1.0",
  "collateralAccountId": "12345678,12345678,12345678",
  "collateralCoin": "BUSD,USDT,ETH",
  "isFlexibleRate": true,
  "timestamp": 1770736694138
}

json

Example Responses

{
  "loanAccountId": "12345678",
  "requestId": "12345678",
  "loanCoin": "BTC",
  "isFlexibleRate": "Yes",
  "loanAmount": "100.55",
  "collateralAccountId": "12345678,12345678,12345678",
  "collateralCoin": "BUSD,USDT,ETH",
  "loanTerm": "30"
}

json

application/json

VIP Loan Fixed Rate Borrow (TRADE)

Submit a fixed rate borrow request by matching market supply orders.

POST

/sapi/v1/loan/vip/fixed/borrow

https://api.binance.com

VIP Loan Fixed Rate Borrow (TRADE) › 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

VIP Loan Fixed Rate Borrow (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Fixed Rate Borrow (TRADE) › 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

VIP Loan Fixed Rate Borrow (TRADE) › Request Body

supplyRequest

string · required

Supply request string, positional encoding (no key). Multiple entries separated by ;, fields separated by :, order: <requestId>:<interestRate>:<amount>. Example: 1212:0.12:100;3434:0.13:50

Example: 1212:0.12:100;3434:0.13:50

borrowCoin

string · required

Borrow coin

Example: BUSD

loanTerm

integer · int64 · required

Loan term in days

Example: 30

borrowUid

integer · int64 · required

Borrow receiving account UID

Example: 12345678

collateralCoin

string · required

Collateral coin(s), multiple separated by ,. Only coin names, no amount (VIP loan collateral amount = entire spot account balance)

Example: BNB,ETH,BTC

collateralAccountId

string · required

Collateral account ID(s), multiple separated by ,

Example: 12345,67890,13579

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

autoRepay

boolean

Default: true. true: auto repay at expiration; false: auto-convert to flexible (floating rate) at expiration

Example: true

Default: true

recvWindow

integer · int64 · max: 60000

The value cannot be greater than 60000

Example: 5000

VIP Loan Fixed Rate Borrow (TRADE) › Responses

200

VIP Loan Fixed Rate Borrow

borrowCoin

string

Echo of input parameter

Example: BUSD

borrowAmount

string

Actual total borrow amount (aggregated when multiple supplyRequest)

Example: 100.5

actualReceivedAmount

string

Actual received amount

Example: 98.75

collateralCoin

string

Echo of input parameter, comma-separated

Example: BNB,ETH,BTC

collateralAccountId

string

Echo of input parameter, comma-separated

Example: 12345,67890,13579

borrowInterestRate

string

Actual borrow interest rate (weighted average when multiple)

Example: 0.01501231

duration

string

{loanTerm}Days, e.g. "30Days"

Example: 30Days

autoRepay

boolean

Echo of input parameter

Example: true

orderId

integer · int64

Order ID

Example: 123456789

status

string

Succeeds / Failed / Processing

Example: Succeeds

POST/sapi/v1/loan/vip/fixed/borrow

curl --request POST \
  --url https://api.binance.com/sapi/v1/loan/vip/fixed/borrow \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data 'supplyRequest=1212:0.12:100;3434:0.13:50' \
  --data borrowCoin=BUSD \
  --data loanTerm=30 \
  --data borrowUid=12345678 \
  --data 'collateralCoin=BNB,ETH,BTC' \
  --data 'collateralAccountId=12345,67890,13579' \
  --data timestamp=1770736694138

Example Request Body

{
  "supplyRequest": "1212:0.12:100;3434:0.13:50",
  "borrowCoin": "BUSD",
  "loanTerm": 30,
  "borrowUid": 12345678,
  "collateralCoin": "BNB,ETH,BTC",
  "collateralAccountId": "12345,67890,13579",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "borrowCoin": "BUSD",
  "borrowAmount": "100.5",
  "actualReceivedAmount": "98.75",
  "collateralCoin": "BNB,ETH,BTC",
  "collateralAccountId": "12345,67890,13579",
  "borrowInterestRate": "0.01501231",
  "duration": "30Days",
  "autoRepay": true,
  "orderId": 123456789,
  "status": "Succeeds"
}

json

application/json

VIP Loan Renew (TRADE)

VIP loan is available for VIP users only.

POST

/sapi/v1/loan/vip/renew

https://api.binance.com

VIP Loan Renew (TRADE) › 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

VIP Loan Renew (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Renew (TRADE) › 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

VIP Loan Renew (TRADE) › Request Body

orderId

integer · int64 · required

Example: 1

loanTerm

integer · int64 · required

30/60 days

Example: 30

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

recvWindow

integer · int64 · max: 60000

Example: 5000

VIP Loan Renew (TRADE) › Responses

200

VIP Loan Renew

loanAccountId

string

Loan receiving account.

Example: 12345678

loanCoin

string

Example: BTC

loanAmount

string

Example: 100.55

collateralAccountId

string

Example: 12345677,12345678,12345679

collateralCoin

string

Example: BUSD,USDT,ETH

loanTerm

string

Example: 30

VIP Loan Repay (TRADE)

VIP loan is available for VIP users only.

POST

/sapi/v1/loan/vip/repay

https://api.binance.com

VIP Loan Repay (TRADE) › 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

VIP Loan Repay (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Repay (TRADE) › 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

VIP Loan Repay (TRADE) › Request Body

orderId

integer · int64 · required

Example: 1

amount

number · float · required

Example: 1.0

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

recvWindow

integer · int64 · max: 60000

Example: 5000

VIP Loan Repay (TRADE) › Responses

200

VIP Loan Repay

loanCoin

string

Example: BUSD

repayAmount

string

Example: 200.5

remainingPrincipal

string

Example: 100.5

remainingInterest

string

Example: 0

collateralCoin

string

Example: BNB,BTC,ETH

currentLTV

string

Example: 0.25

repayStatus

string

Repayment status (Repaid, Repaying, Failed).

Example: Repaid

VIP Loan Borrow (TRADE)

VIP loan is available for VIP users only.

POST

/sapi/v1/loan/vip/borrow

https://api.binance.com

VIP Loan Borrow (TRADE) › 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

VIP Loan Borrow (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Borrow (TRADE) › 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

VIP Loan Borrow (TRADE) › Request Body

loanAccountId

integer · int64 · required

Example: 1

loanCoin

string · required

Example: BTC

loanAmount

number · float · required

Example: 1.0

collateralAccountId

string · required

Collateral account ID(s). Multiple split by ,

Example: 12345678,12345678,12345678

collateralCoin

string · required

Example: BUSD,USDT,ETH

isFlexibleRate

boolean · required

TRUE: flexible rate; FALSE: fixed rate

Example: true

Default: 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

loanTerm

integer · int64

Mandatory for fixed rate. Optional for flexible rate. e.g. 30/60 days

Example: 30

recvWindow

integer · int64 · max: 60000

Example: 5000

VIP Loan Borrow (TRADE) › Responses

200

VIP Loan Borrow

loanAccountId

string

Loan receiving account.

Example: 12345678

requestId

string

Example: 12345678

loanCoin

string

Example: BTC

isFlexibleRate

string

Example: Yes

loanAmount

string

Example: 100.55

collateralAccountId

string

Example: 12345678,12345678,12345678

collateralCoin

string

Example: BUSD,USDT,ETH

loanTerm

string

Example: 30

VIP Loan Fixed Rate Borrow (TRADE)

Submit a fixed rate borrow request by matching market supply orders.

POST

/sapi/v1/loan/vip/fixed/borrow

https://api.binance.com

VIP Loan Fixed Rate Borrow (TRADE) › 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

VIP Loan Fixed Rate Borrow (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Fixed Rate Borrow (TRADE) › 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

VIP Loan Fixed Rate Borrow (TRADE) › Request Body

supplyRequest

string · required

Supply request string, positional encoding (no key). Multiple entries separated by ;, fields separated by :, order: <requestId>:<interestRate>:<amount>. Example: 1212:0.12:100;3434:0.13:50

Example: 1212:0.12:100;3434:0.13:50

borrowCoin

string · required

Borrow coin

Example: BUSD

loanTerm

integer · int64 · required

Loan term in days

Example: 30

borrowUid

integer · int64 · required

Borrow receiving account UID

Example: 12345678

collateralCoin

string · required

Collateral coin(s), multiple separated by ,. Only coin names, no amount (VIP loan collateral amount = entire spot account balance)

Example: BNB,ETH,BTC

collateralAccountId

string · required

Collateral account ID(s), multiple separated by ,

Example: 12345,67890,13579

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

autoRepay

boolean

Default: true. true: auto repay at expiration; false: auto-convert to flexible (floating rate) at expiration

Example: true

Default: true

recvWindow

integer · int64 · max: 60000

The value cannot be greater than 60000

Example: 5000

VIP Loan Fixed Rate Borrow (TRADE) › Responses

200

VIP Loan Fixed Rate Borrow

borrowCoin

string

Echo of input parameter

Example: BUSD

borrowAmount

string

Actual total borrow amount (aggregated when multiple supplyRequest)

Example: 100.5

actualReceivedAmount

string

Actual received amount

Example: 98.75

collateralCoin

string

Echo of input parameter, comma-separated

Example: BNB,ETH,BTC

collateralAccountId

string

Echo of input parameter, comma-separated

Example: 12345,67890,13579

borrowInterestRate

string

Actual borrow interest rate (weighted average when multiple)

Example: 0.01501231

duration

string

{loanTerm}Days, e.g. "30Days"

Example: 30Days

autoRepay

boolean

Echo of input parameter

Example: true

orderId

integer · int64

Order ID

Example: 123456789

status

string

Succeeds / Failed / Processing

Example: Succeeds

VIP Loan Renew (TRADE)

VIP loan is available for VIP users only.

POST

/sapi/v1/loan/vip/renew

https://api.binance.com

VIP Loan Renew (TRADE) › 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

VIP Loan Renew (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Renew (TRADE) › 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

VIP Loan Renew (TRADE) › Request Body

orderId

integer · int64 · required

Example: 1

loanTerm

integer · int64 · required

30/60 days

Example: 30

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

recvWindow

integer · int64 · max: 60000

Example: 5000

VIP Loan Renew (TRADE) › Responses

200

VIP Loan Renew

loanAccountId

string

Loan receiving account.

Example: 12345678

loanCoin

string

Example: BTC

loanAmount

string

Example: 100.55

collateralAccountId

string

Example: 12345677,12345678,12345679

collateralCoin

string

Example: BUSD,USDT,ETH

loanTerm

string

Example: 30

VIP Loan Repay (TRADE)

VIP loan is available for VIP users only.

POST

/sapi/v1/loan/vip/repay

https://api.binance.com

VIP Loan Repay (TRADE) › 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

VIP Loan Repay (TRADE) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight6000

VIP Loan Repay (TRADE) › 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

VIP Loan Repay (TRADE) › Request Body

orderId

integer · int64 · required

Example: 1

amount

number · float · required

Example: 1.0

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

recvWindow

integer · int64 · max: 60000

Example: 5000

VIP Loan Repay (TRADE) › Responses

200

VIP Loan Repay

loanCoin

string

Example: BUSD

repayAmount

string

Example: 200.5

remainingPrincipal

string

Example: 100.5

remainingInterest

string

Example: 0

collateralCoin

string

Example: BNB,BTC,ETH

currentLTV

string

Example: 0.25

repayStatus

string

Repayment status (Repaid, Repaying, Failed).

Example: Repaid