VIP Loan Fixed Rate Borrow(TRADE)

API Description

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

HTTP Request

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

Request Weight(UID)

6000

Request Parameters

Name	Type	Mandatory	Description
supplyRequest	STRING	YES	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
borrowCoin	STRING	YES	Borrow coin
loanTerm	INTEGER	YES	Loan term in days
borrowUid	LONG	YES	Borrow receiving account UID
collateralCoin	STRING	YES	Collateral coin(s), multiple separated by ,. Only coin names, no amount (VIP loan collateral amount = entire spot account balance)
collateralAccountId	STRING	YES	Collateral account ID(s), multiple separated by ,
autoRepay	BOOLEAN	NO	Default: true. true: auto repay at expiration; false: auto-convert to flexible (floating rate) at expiration
recvWindow	LONG	NO	The value cannot be greater than 60000
timestamp	LONG	YES

• Rate limit: 2 requests per second per account.
• When multiple supplyRequest entries are provided, all requestId values must correspond to the same borrowCoin and loanTerm (validated by collateral facade).

Response Example

{
    "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"
}

Response Fields:

Name	Type	Description
borrowCoin	STRING	Echo of input parameter
borrowAmount	DECIMAL	Actual total borrow amount (aggregated when multiple supplyRequest)
actualReceivedAmount	DECIMAL	Actual received amount
collateralCoin	STRING	Echo of input parameter, comma-separated
collateralAccountId	STRING	Echo of input parameter, comma-separated
borrowInterestRate	DECIMAL	Actual borrow interest rate (weighted average when multiple)
duration	STRING	{loanTerm}Days, e.g. "30Days"
autoRepay	BOOLEAN	Echo of input parameter
orderId	LONG	Order ID
status	STRING	Succeeds / Failed / Processing