Borrow and Repay

Endpoint

Risk Unit Borrow (TRADE)

This endpoint is used to perform a borrow request for that specified risk unit. This endpoint is accessible only with the credit account API key.

You need to open Enable Spot & Margin Trading permission for the API Key which requests this endpoint.
The amount field refers to the quantity of the borrowed asset. The maximum allowable amount is subject to collateral ratio adjustment. The applicable collateral ratio depends on the margin mode of the credit account.

POST

/sapi/v1/margin/loan-group/borrow

https://api.binance.com

Risk Unit 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

Risk Unit 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 Weight3000

Risk Unit 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

Risk Unit Borrow (TRADE) › Request Body

groupId

integer · int64 · required

Example: 1

assetName

string · required

Asset Name , USDT or USDC or BTC or U

Example: USDT

amount

number · float · required

Example: 1

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

Risk Unit Borrow (TRADE) › Responses

200

Risk Unit Borrow

transactionId

integer · int64

Example: 12317283617

amount

number · float

Example: 123456.78

status

string

Example: success

Risk Unit Borrow/Repay Records (USER_DATA)

Get borrow/repay records in the Institution Loan Risk Unit. This endpoint is accessible only with the credit account API key.

GET

/sapi/v1/margin/loan-group/borrow-repay

https://api.binance.com

Risk Unit Borrow/Repay Records (USER_DATA) › 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

Risk Unit Borrow/Repay Records (USER_DATA) › 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

Risk Unit Borrow/Repay Records (USER_DATA) › 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

Risk Unit Borrow/Repay Records (USER_DATA) › Query Parameters

type

string · enum · required

BORROW or REPAY

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

groupId

integer · int64

Risk unit unique identifier

Example: 1

asset

string

Asset name, for example USDT or USDC

Example: USDT

startTime

integer · int64

Start time in milliseconds.

Example: 1750420000000

endTime

integer · int64

End time in milliseconds.

Example: 1750420899036

current

integer · int64

Current page number. Starts from 1.

Example: 1

Default: 1

size

integer · int64 · max: 100

Number of records per page.

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds.

Example: 5000

Risk Unit Borrow/Repay Records (USER_DATA) › Responses

200

Risk Unit Borrow/Repay Records

total

integer · int64

Example: 1

object[]

tranId

integer · int64

Example: 1648963682

assetName

string

Example: USDT

amount

number · float

Example: 300

principal

number · float

Example: 298

interest

number · float

Example: 2

status

string

Example: CONFIRM

type

string

BORROW, NORMAL_REPAY, FORCE_REPAY

Example: BORROW

timestamp

integer · int64

Example: 1750420899036

Risk Unit Interest History (USER_DATA)

Query Institutional loan risk unit interest history. This endpoint is accessible only with the credit account API key.

GET

/sapi/v1/margin/loan-group/interest-history

https://api.binance.com

Risk Unit Interest History (USER_DATA) › 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

Risk Unit Interest History (USER_DATA) › 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

Risk Unit Interest History (USER_DATA) › 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

Risk Unit Interest History (USER_DATA) › 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

groupId

integer · int64

Unique risk unit identifier

Example: 1

asset

string

Asset name, for example USDT or USDC.

Example: USDT

startTime

integer · int64

Start time in milliseconds.

Example: 1623319461670

endTime

integer · int64

End time in milliseconds.

Example: 1641782889000

current

integer · int64

Current page number. Starts from 1.

Example: 1

Default: 1

size

integer · int64 · max: 100

Number of records per page.

Example: 10

Default: 10

Risk Unit Interest History (USER_DATA) › Responses

200

Risk Unit Interest History

total

integer · int64

Number of historical interest records.

Example: 2

object[]

Interest history records.

groupId

integer · int64

Example: 2

assetName

string

Example: USDC

principal

number · float

Example: 851340.57601652

interestRate

number · float

Example: 0.00000833

interest

number · float

Example: 7.09447643

interestTimestamp

integer · int64

Example: 1746442800000

Risk Unit Repay (TRADE)

This endpoint is used to perform full or partial repayment of the specified risk unit. This endpoint is accessible only with the credit account API key.

By default (repayFrom=MARGIN), funds are deducted from the credit account's Margin account. When repayFrom=SPOT, funds are deducted directly from the credit account's Spot account.

You need to open Enable Spot & Margin Trading permission for the API Key which requests this endpoint.

POST

/sapi/v1/margin/loan-group/repay

https://api.binance.com

Risk Unit 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

Risk Unit 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 Weight3000

Risk Unit 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

Risk Unit Repay (TRADE) › Request Body

groupId

integer · int64 · required

Example: 1

assetName

string · required

Asset name to repay

Example: USDT

amount

number · float · required

Example: 1

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

repayFrom

string

Funding source for repayment. MARGIN (default): deduct from credit account's Margin account. SPOT: deduct directly from credit account's Spot account.

Example: MARGIN

Risk Unit Repay (TRADE) › Responses

200

Risk Unit Repay

transactionId

integer · int64

Example: 12317283617

amount

number · float

Example: 123456.78

repayFrom

string

Funding source used for this repayment.

Example: MARGIN

Query Interest Rebate Balance (USER_DATA)

Query the interest rebate balance for an institutional loan master account, including the remaining balance, total granted amount, and total consumed amount, all denominated in USDT. This endpoint requires authentication with the parent account API key.

GET

/sapi/v1/margin/loan-group/interest-rebate-balance

https://api.binance.com

Query Interest Rebate Balance (USER_DATA) › 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 Interest Rebate Balance (USER_DATA) › 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

Query Interest Rebate Balance (USER_DATA) › 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 Interest Rebate Balance (USER_DATA) › 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

Query Interest Rebate Balance (USER_DATA) › Responses

200

Query Interest Rebate Balance

asset

string

Asset name

Example: USDT

balance

string

Current rebate balance remaining; represents the amount still available to offset future interest charges

Example: 91.64958606

totalGranted

string

The total rebate amount that has ever been credited to your account

Example: 150.00000000

totalConsumed

string

The total rebate amount that has already been used up to pay off interest

Example: 58.35041394

Query Interest Rebate Balance Records (USER_DATA)

Query change records for an institutional loan interest rebate balance. Includes ADD (admin grant), DEDUCT (admin deduction), and INTEREST_OFFSET (system interest deduction) types.

GET

/sapi/v1/margin/loan-group/interest-rebate-balance/records

https://api.binance.com

Query Interest Rebate Balance Records (USER_DATA) › 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 Interest Rebate Balance Records (USER_DATA) › 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

Query Interest Rebate Balance Records (USER_DATA) › 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 Interest Rebate Balance Records (USER_DATA) › 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

type

integer · enum

Record type filter: 0=ADD, 1=DEDUCT, 2=INTEREST_OFFSET. Returns all if not specified.

Enum values:

Example: 0

startTime

integer · int64

Start time in ms

Example: 1711843200000

endTime

integer · int64

End time in ms

Example: 1712102400000

current

integer · int64

Page number, default 1

Example: 1

Default: 1

size

integer · int64 · max: 100

Page size, default 10, max 100

Example: 10

Default: 10

Query Interest Rebate Balance Records (USER_DATA) › Responses

200

Query Interest Rebate Balance Records

total

integer · int64

Total number of records

Example: 3

object[]

type

string · enum

ADD / DEDUCT / INTEREST_OFFSET

Enum values:

ADD

DEDUCT

INTEREST_OFFSET

Example: ADD

groupId

integer · int64

Loan group ID (only for INTEREST_OFFSET)

Example: 10005

rebateAsset

string

Rebate asset (USDT)

Example: USDT

delta

string

Amount change. Positive for ADD, negative for DEDUCT/INTEREST_OFFSET

Example: 5000.00000000

liabilityAsset

string

Liability asset (only for INTEREST_OFFSET)

Example: BTC

deductedInterest

string

Deducted interest in liability asset (only for INTEREST_OFFSET)

Example: 0.00050123

exchangeRate

string

Exchange rate snapshot (only for INTEREST_OFFSET)

Example: 0.00001000

createTime

integer · int64

Record creation time in ms

Example: 1711843200000

Query Loan Group Max Borrowable (USER_DATA)

Query the maximum borrowable amount of a given asset for an institutional loan risk unit.

This endpoint can be accessed using the API key from either the parent or the credit account:

If the API key belongs to the credit account, groupId is optional. When omitted, the member's own risk unit is used; when provided, it must match the member's risk unit, otherwise an empty result is returned.
If the API key belongs to the parent account, groupId is required and must be owned by the parent account, otherwise an empty result is returned.
If the caller is neither the parent account nor the credit member of the group (e.g., a collateral member, or no matching risk unit), maxBorrowableAmount is returned as empty/null.

GET

/sapi/v1/margin/loan-group/max-borrowable

https://api.binance.com

Query Loan Group Max Borrowable (USER_DATA) › 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 Loan Group Max Borrowable (USER_DATA) › 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

Query Loan Group Max Borrowable (USER_DATA) › 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 Loan Group Max Borrowable (USER_DATA) › Query Parameters

assetName

string · required

Asset to borrow, e.g., USDT. Case-insensitive (normalized to upper-case). Must be a borrowable asset, otherwise an error is returned.

Example: USDT

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

groupId

integer · int64

Loan group id. Optional when the API key belongs to the credit member; required when it belongs to the parent account.

Example: 123456789

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Loan Group Max Borrowable (USER_DATA) › Responses

200

Query Loan Group Max Borrowable

maxBorrowableAmount

string

Max borrowable amount of the asset for the risk unit. Empty/null when the caller has no matching risk unit.

Example: 12345.67890000

Borrow and Repay

Endpoint

Download schema

Risk Unit Borrow (TRADE)

This endpoint is used to perform a borrow request for that specified risk unit. This endpoint is accessible only with the credit account API key.

You need to open Enable Spot & Margin Trading permission for the API Key which requests this endpoint.
The amount field refers to the quantity of the borrowed asset. The maximum allowable amount is subject to collateral ratio adjustment. The applicable collateral ratio depends on the margin mode of the credit account.

POST

/sapi/v1/margin/loan-group/borrow

https://api.binance.com

Risk Unit 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

Risk Unit 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 Weight3000

Risk Unit 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

Risk Unit Borrow (TRADE) › Request Body

groupId

integer · int64 · required

Example: 1

assetName

string · required

Asset Name , USDT or USDC or BTC or U

Example: USDT

amount

number · float · required

Example: 1

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

Risk Unit Borrow (TRADE) › Responses

200

Risk Unit Borrow

transactionId

integer · int64

Example: 12317283617

amount

number · float

Example: 123456.78

status

string

Example: success

Risk Unit Borrow/Repay Records (USER_DATA)

Get borrow/repay records in the Institution Loan Risk Unit. This endpoint is accessible only with the credit account API key.

GET

/sapi/v1/margin/loan-group/borrow-repay

https://api.binance.com

Risk Unit Borrow/Repay Records (USER_DATA) › 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

Risk Unit Borrow/Repay Records (USER_DATA) › 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

Risk Unit Borrow/Repay Records (USER_DATA) › 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

Risk Unit Borrow/Repay Records (USER_DATA) › Query Parameters

type

string · enum · required

BORROW or REPAY

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

groupId

integer · int64

Risk unit unique identifier

Example: 1

asset

string

Asset name, for example USDT or USDC

Example: USDT

startTime

integer · int64

Start time in milliseconds.

Example: 1750420000000

endTime

integer · int64

End time in milliseconds.

Example: 1750420899036

current

integer · int64

Current page number. Starts from 1.

Example: 1

Default: 1

size

integer · int64 · max: 100

Number of records per page.

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds.

Example: 5000

Risk Unit Borrow/Repay Records (USER_DATA) › Responses

200

Risk Unit Borrow/Repay Records

total

integer · int64

Example: 1

object[]

tranId

integer · int64

Example: 1648963682

assetName

string

Example: USDT

amount

number · float

Example: 300

principal

number · float

Example: 298

interest

number · float

Example: 2

status

string

Example: CONFIRM

type

string

BORROW, NORMAL_REPAY, FORCE_REPAY

Example: BORROW

timestamp

integer · int64

Example: 1750420899036

Risk Unit Interest History (USER_DATA)

Query Institutional loan risk unit interest history. This endpoint is accessible only with the credit account API key.

GET

/sapi/v1/margin/loan-group/interest-history

https://api.binance.com

Risk Unit Interest History (USER_DATA) › 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

Risk Unit Interest History (USER_DATA) › 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

Risk Unit Interest History (USER_DATA) › 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

Risk Unit Interest History (USER_DATA) › 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

groupId

integer · int64

Unique risk unit identifier

Example: 1

asset

string

Asset name, for example USDT or USDC.

Example: USDT

startTime

integer · int64

Start time in milliseconds.

Example: 1623319461670

endTime

integer · int64

End time in milliseconds.

Example: 1641782889000

current

integer · int64

Current page number. Starts from 1.

Example: 1

Default: 1

size

integer · int64 · max: 100

Number of records per page.

Example: 10

Default: 10

Risk Unit Interest History (USER_DATA) › Responses

200

Risk Unit Interest History

total

integer · int64

Number of historical interest records.

Example: 2

object[]

Interest history records.

groupId

integer · int64

Example: 2

assetName

string

Example: USDC

principal

number · float

Example: 851340.57601652

interestRate

number · float

Example: 0.00000833

interest

number · float

Example: 7.09447643

interestTimestamp

integer · int64

Example: 1746442800000

Risk Unit Repay (TRADE)

This endpoint is used to perform full or partial repayment of the specified risk unit. This endpoint is accessible only with the credit account API key.

By default (repayFrom=MARGIN), funds are deducted from the credit account's Margin account. When repayFrom=SPOT, funds are deducted directly from the credit account's Spot account.

You need to open Enable Spot & Margin Trading permission for the API Key which requests this endpoint.

POST

/sapi/v1/margin/loan-group/repay

https://api.binance.com

Risk Unit 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

Risk Unit 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 Weight3000

Risk Unit 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

Risk Unit Repay (TRADE) › Request Body

groupId

integer · int64 · required

Example: 1

assetName

string · required

Asset name to repay

Example: USDT

amount

number · float · required

Example: 1

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

repayFrom

string

Funding source for repayment. MARGIN (default): deduct from credit account's Margin account. SPOT: deduct directly from credit account's Spot account.

Example: MARGIN

Risk Unit Repay (TRADE) › Responses

200

Risk Unit Repay

transactionId

integer · int64

Example: 12317283617

amount

number · float

Example: 123456.78

repayFrom

string

Funding source used for this repayment.

Example: MARGIN

Query Interest Rebate Balance (USER_DATA)

GET

/sapi/v1/margin/loan-group/interest-rebate-balance

https://api.binance.com

Query Interest Rebate Balance (USER_DATA) › 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 Interest Rebate Balance (USER_DATA) › 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

Query Interest Rebate Balance (USER_DATA) › 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 Interest Rebate Balance (USER_DATA) › 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

Query Interest Rebate Balance (USER_DATA) › Responses

200

Query Interest Rebate Balance

asset

string

Asset name

Example: USDT

balance

string

Current rebate balance remaining; represents the amount still available to offset future interest charges

Example: 91.64958606

totalGranted

string

The total rebate amount that has ever been credited to your account

Example: 150.00000000

totalConsumed

string

The total rebate amount that has already been used up to pay off interest

Example: 58.35041394

Query Interest Rebate Balance Records (USER_DATA)

Query change records for an institutional loan interest rebate balance. Includes ADD (admin grant), DEDUCT (admin deduction), and INTEREST_OFFSET (system interest deduction) types.

GET

/sapi/v1/margin/loan-group/interest-rebate-balance/records

https://api.binance.com

Query Interest Rebate Balance Records (USER_DATA) › 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 Interest Rebate Balance Records (USER_DATA) › 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

Query Interest Rebate Balance Records (USER_DATA) › 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 Interest Rebate Balance Records (USER_DATA) › 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

type

integer · enum

Record type filter: 0=ADD, 1=DEDUCT, 2=INTEREST_OFFSET. Returns all if not specified.

Enum values:

Example: 0

startTime

integer · int64

Start time in ms

Example: 1711843200000

endTime

integer · int64

End time in ms

Example: 1712102400000

current

integer · int64

Page number, default 1

Example: 1

Default: 1

size

integer · int64 · max: 100

Page size, default 10, max 100

Example: 10

Default: 10

Query Interest Rebate Balance Records (USER_DATA) › Responses

200

Query Interest Rebate Balance Records

total

integer · int64

Total number of records

Example: 3

object[]

type

string · enum

ADD / DEDUCT / INTEREST_OFFSET

Enum values:

ADD

DEDUCT

INTEREST_OFFSET

Example: ADD

groupId

integer · int64

Loan group ID (only for INTEREST_OFFSET)

Example: 10005

rebateAsset

string

Rebate asset (USDT)

Example: USDT

delta

string

Amount change. Positive for ADD, negative for DEDUCT/INTEREST_OFFSET

Example: 5000.00000000

liabilityAsset

string

Liability asset (only for INTEREST_OFFSET)

Example: BTC

deductedInterest

string

Deducted interest in liability asset (only for INTEREST_OFFSET)

Example: 0.00050123

exchangeRate

string

Exchange rate snapshot (only for INTEREST_OFFSET)

Example: 0.00001000

createTime

integer · int64

Record creation time in ms

Example: 1711843200000

Query Loan Group Max Borrowable (USER_DATA)

Query the maximum borrowable amount of a given asset for an institutional loan risk unit.

This endpoint can be accessed using the API key from either the parent or the credit account:

If the API key belongs to the credit account, groupId is optional. When omitted, the member's own risk unit is used; when provided, it must match the member's risk unit, otherwise an empty result is returned.
If the API key belongs to the parent account, groupId is required and must be owned by the parent account, otherwise an empty result is returned.
If the caller is neither the parent account nor the credit member of the group (e.g., a collateral member, or no matching risk unit), maxBorrowableAmount is returned as empty/null.

GET

/sapi/v1/margin/loan-group/max-borrowable

https://api.binance.com

Query Loan Group Max Borrowable (USER_DATA) › 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 Loan Group Max Borrowable (USER_DATA) › 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

Query Loan Group Max Borrowable (USER_DATA) › 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 Loan Group Max Borrowable (USER_DATA) › Query Parameters

assetName

string · required

Asset to borrow, e.g., USDT. Case-insensitive (normalized to upper-case). Must be a borrowable asset, otherwise an error is returned.

Example: USDT

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

groupId

integer · int64

Loan group id. Optional when the API key belongs to the credit member; required when it belongs to the parent account.

Example: 123456789

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Loan Group Max Borrowable (USER_DATA) › Responses

200

Query Loan Group Max Borrowable

maxBorrowableAmount

string

Max borrowable amount of the asset for the risk unit. Empty/null when the caller has no matching risk unit.

Example: 12345.67890000