Account

Endpoint

Download schema

Add Collateral Accounts (TRADE)

Add new collateral accounts for the Risk Unit. This endpoint is accessible only with the parent account API key.

For the credit account, the enableMargin should always be TRUE.
Collateral sub-accounts can be added to the Risk Unit but cannot be removed. Therefore, the enableSpot or enableMargin parameters cannot be switched from TRUE to FALSE once the sub-account is activated in the Risk Unit. If you need to remove credit or collateral sub-accounts from the Risk Unit, please contact the Binance Margin team for support.

POST

/sapi/v1/margin/loan-group/edit-member

https://api.binance.com

Add Collateral Accounts (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

Add Collateral Accounts (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 Weight1000

Add Collateral Accounts (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

Add Collateral Accounts (TRADE) › Request Body

groupId

integer · int64 · required

Example: 1

subEmail

string · required

Example: abc@test.com

enableSpot

boolean · required

Example: true

enableMargin

boolean · required

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

Add Collateral Accounts (TRADE) › Responses

200

Add Collateral Accounts

status

integer · int64

Example: 0

Query One Risk Unit Detail (USER_DATA)

Query One Institution Loan Group Details which is executed by credit account

GET

/sapi/v1/margin/loan-group

https://api.binance.com

Query One Risk Unit Detail (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 One Risk Unit Detail (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 Weight3000

Query One Risk Unit Detail (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 One Risk Unit Detail (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 One Risk Unit Detail (USER_DATA) › Responses

200

One Risk Unit Detail

groupId

integer · int64

Example: 3

parentEmail

string

Example: parent001@test.com

creditEmail

string

Example: credit001@test.com

updateTime

integer · int64

Example: 1747910351205

ltv

string

Example: 0.336

totalNetEquity

string

Example: 598569.620904

totalMaintenanceMargin

string

Example: 375.23555369

totalLiability

string

Example: 200850.274625

object[]

assetName

string

Example: USDT

principal

string

Example: 200099.9

interest

string

Example: 750.374625

object[]

email

string

Example: collateral001@test.com

accountType

string

Example: PORTFOLIO_MARGIN

netEquity

string

Example: 219961.43492975

maintainMargin

string

Example: 50.10676987

Close Risk Unit (TRADE)

The closure of the Institutional Loan risk unit can only be initiated by API calls from the credit account. If the closure is successful all the collateral accounts will be unlinked. Please note the following conditions must be met:

The Institution Loan risk unit is active.
The outstanding institutional loan liabilities for that particular risk unit have been repaid.

DELETE

/sapi/v1/margin/loan-group

https://api.binance.com

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

Close Risk Unit (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 Weight1000

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

Close Risk Unit (TRADE) › Query Parameters

groupId

integer · int64 · required

Risk unit unique identifier

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

Close Risk Unit (TRADE) › Responses

200

Close Risk Unit

groupId

integer · int64

Risk unit unique identifier

Example: 10001

status

string

CLOSED: This risk unit has been closed successfully

Example: CLOSED

Query Closed Risk Unit Record (USER_DATA)

Query closed risk unit record. This endpoint is accessible only with the credit account API key.

GET

/sapi/v1/margin/loan-groups/closed

https://api.binance.com

Query Closed Risk Unit Record (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 Closed Risk Unit Record (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 Weight1

Query Closed Risk Unit Record (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 Closed Risk Unit Record (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

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

Query Closed Risk Unit Record (USER_DATA) › Responses

200

Closed Risk Unit Records

total

integer · int64

Total number of risk units returned by the query.

Example: 2

object[]

groupId

integer · int64

Risk unit unique identifier.

Example: 72

parentEmail

string

Parent account email

Example: wdywgceiwbfq@test.com

creditEmail

string

Credit account email

Example: wdywaxmzlnah@test.com

enabled

boolean

The status of the group. TRUE for enabled; FALSE for disabled.

Example: false

createTime

integer · int64

The group create timestamp (milliseconds)

Example: 1753410654608

closeTime

integer · int64

The group close timestamp (milliseconds)

Example: 1753422899052

Query Active Risk Units (USER_DATA)

Retrieves the list of active institutional loan risk units. This endpoint is accessible only with the parent account API key.

GET

/sapi/v1/margin/loan-groups/activated

https://api.binance.com

Query Active Risk Units (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 Active Risk Units (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

Query Active Risk Units (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 Active Risk Units (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 Active Risk Units (USER_DATA) › Responses

200

Active Risk Units

object

groupId

integer · int64

Risk unit unique identifier

Example: 10001

object[]

email

string

Account registered email

Example: 1001@test.com

type

string

Credit sub account or Collateral sub account

Example: CREDIT

enableMargin

boolean

TRUE: include margin account as collateral.
FALSE: exclude margin account as collateral

Example: true

enableSpot

boolean

TRUE: include spot account as collateral
FALSE: exclude spot account as collateral

Example: true

createTime

integer · int64

Last update timestamp in milliseconds

Example: 1747637956083

Query Risk Unit Details (USER_DATA)

Queries institutional loan risk unit details. Both master accounts and borrowing accounts can call this endpoint.

Master account:
- If groupId is not provided, details of all risk units are returned.
- If a specific groupId is provided, details of that risk unit are returned.
Borrowing account:
- Only risk units bound to that borrowing account can be queried.
Other account types:
- LTV details cannot be queried and no results are returned.

GET

/sapi/v1/margin/loan-group/ltv-details

https://api.binance.com

Query Risk Unit Details (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 Risk Unit Details (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 Weight200

Query Risk Unit Details (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 Risk Unit Details (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

Risk unit unique identifier

Example: 1

Query Risk Unit Details (USER_DATA) › Responses

200

Risk Unit Details

object

groupId

integer · int64

Example: 1

parentEmail

string

Example: andrew.kemmer001@test.com

creditEmail

string

Example: tst20241120@test.com

updateTime

integer · int64

Example: 1752137105623

ltv

string

Example: 0.592

totalNetEquity

string

Example: 26.35196946

totalMaintenanceMargin

string

Example: 0.50106177

totalLiability

string

Example: 15.30718771

parentAccountFrozenAmount

string

Example: 8.18753688

maxTransferOutAmount

string

Example: 0

maxAllowedBorrowLimit

string

The USDT-equivalent maximum borrowable amount for this risk unit. Note: this value does not account for the borrowed asset's collateral ratio. For assets with a collateral ratio below 100%, the actual maximum borrowable quantity still considers the borrowed asset's collateral ratio. The applicable collateral ratio depends on the margin mode of the credit account.

Example: 16.32397222

object[]

assetName

string

Example: USDT

principal

string

Example: 15.30718771

interest

string

Example: 0

object[]

email

string

Example: collateral001@test.com

type

string

Example: COLLATERAL

object[]

accountType

string

Example: SPOT

netEquity

string

Example: 5

maintainMargin

string

Example: 0

GET/sapi/v1/margin/loan-group/ltv-details

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/margin/loan-group/ltv-details?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "groupId": 1,
    "parentEmail": "andrew.kemmer001@test.com",
    "creditEmail": "tst20241120@test.com",
    "updateTime": 1752137105623,
    "ltv": "0.592",
    "totalNetEquity": "26.35196946",
    "totalMaintenanceMargin": "0.50106177",
    "totalLiability": "15.30718771",
    "parentAccountFrozenAmount": "8.18753688",
    "maxTransferOutAmount": "0",
    "maxAllowedBorrowLimit": "16.32397222",
    "liabilities": [
      {
        "assetName": "USDT",
        "principal": "15.30718771",
        "interest": "0"
      }
    ],
    "collateralAccounts": [
      {
        "email": "collateral001@test.com",
        "type": "COLLATERAL",
        "wallets": [
          {
            "accountType": "SPOT",
            "netEquity": "5",
            "maintainMargin": "0"
          }
        ]
      }
    ]
  }
]

json

application/json

Account

Endpoint

Download schema

Add Collateral Accounts (TRADE)

Add new collateral accounts for the Risk Unit. This endpoint is accessible only with the parent account API key.

For the credit account, the enableMargin should always be TRUE.
Collateral sub-accounts can be added to the Risk Unit but cannot be removed. Therefore, the enableSpot or enableMargin parameters cannot be switched from TRUE to FALSE once the sub-account is activated in the Risk Unit. If you need to remove credit or collateral sub-accounts from the Risk Unit, please contact the Binance Margin team for support.

POST

/sapi/v1/margin/loan-group/edit-member

https://api.binance.com

Add Collateral Accounts (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

Add Collateral Accounts (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 Weight1000

Add Collateral Accounts (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

Add Collateral Accounts (TRADE) › Request Body

groupId

integer · int64 · required

Example: 1

subEmail

string · required

Example: abc@test.com

enableSpot

boolean · required

Example: true

enableMargin

boolean · required

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

Add Collateral Accounts (TRADE) › Responses

200

Add Collateral Accounts

status

integer · int64

Example: 0

Query One Risk Unit Detail (USER_DATA)

Query One Institution Loan Group Details which is executed by credit account

GET

/sapi/v1/margin/loan-group

https://api.binance.com

Query One Risk Unit Detail (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 One Risk Unit Detail (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 Weight3000

Query One Risk Unit Detail (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 One Risk Unit Detail (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 One Risk Unit Detail (USER_DATA) › Responses

200

One Risk Unit Detail

groupId

integer · int64

Example: 3

parentEmail

string

Example: parent001@test.com

creditEmail

string

Example: credit001@test.com

updateTime

integer · int64

Example: 1747910351205

ltv

string

Example: 0.336

totalNetEquity

string

Example: 598569.620904

totalMaintenanceMargin

string

Example: 375.23555369

totalLiability

string

Example: 200850.274625

object[]

assetName

string

Example: USDT

principal

string

Example: 200099.9

interest

string

Example: 750.374625

object[]

email

string

Example: collateral001@test.com

accountType

string

Example: PORTFOLIO_MARGIN

netEquity

string

Example: 219961.43492975

maintainMargin

string

Example: 50.10676987

Close Risk Unit (TRADE)

The Institution Loan risk unit is active.
The outstanding institutional loan liabilities for that particular risk unit have been repaid.

DELETE

/sapi/v1/margin/loan-group

https://api.binance.com

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

Close Risk Unit (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 Weight1000

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

Close Risk Unit (TRADE) › Query Parameters

groupId

integer · int64 · required

Risk unit unique identifier

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

Close Risk Unit (TRADE) › Responses

200

Close Risk Unit

groupId

integer · int64

Risk unit unique identifier

Example: 10001

status

string

CLOSED: This risk unit has been closed successfully

Example: CLOSED

Query Closed Risk Unit Record (USER_DATA)

Query closed risk unit record. This endpoint is accessible only with the credit account API key.

GET

/sapi/v1/margin/loan-groups/closed

https://api.binance.com

Query Closed Risk Unit Record (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 Closed Risk Unit Record (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 Weight1

Query Closed Risk Unit Record (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 Closed Risk Unit Record (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

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

Query Closed Risk Unit Record (USER_DATA) › Responses

200

Closed Risk Unit Records

total

integer · int64

Total number of risk units returned by the query.

Example: 2

object[]

groupId

integer · int64

Risk unit unique identifier.

Example: 72

parentEmail

string

Parent account email

Example: wdywgceiwbfq@test.com

creditEmail

string

Credit account email

Example: wdywaxmzlnah@test.com

enabled

boolean

The status of the group. TRUE for enabled; FALSE for disabled.

Example: false

createTime

integer · int64

The group create timestamp (milliseconds)

Example: 1753410654608

closeTime

integer · int64

The group close timestamp (milliseconds)

Example: 1753422899052

Query Active Risk Units (USER_DATA)

Retrieves the list of active institutional loan risk units. This endpoint is accessible only with the parent account API key.

GET

/sapi/v1/margin/loan-groups/activated

https://api.binance.com

Query Active Risk Units (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 Active Risk Units (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

Query Active Risk Units (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 Active Risk Units (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 Active Risk Units (USER_DATA) › Responses

200

Active Risk Units

object

groupId

integer · int64

Risk unit unique identifier

Example: 10001

object[]

email

string

Account registered email

Example: 1001@test.com

type

string

Credit sub account or Collateral sub account

Example: CREDIT

enableMargin

boolean

TRUE: include margin account as collateral.
FALSE: exclude margin account as collateral

Example: true

enableSpot

boolean

TRUE: include spot account as collateral
FALSE: exclude spot account as collateral

Example: true

createTime

integer · int64

Last update timestamp in milliseconds

Example: 1747637956083

Query Risk Unit Details (USER_DATA)

Queries institutional loan risk unit details. Both master accounts and borrowing accounts can call this endpoint.

Master account:
- If groupId is not provided, details of all risk units are returned.
- If a specific groupId is provided, details of that risk unit are returned.
Borrowing account:
- Only risk units bound to that borrowing account can be queried.
Other account types:
- LTV details cannot be queried and no results are returned.

GET

/sapi/v1/margin/loan-group/ltv-details

https://api.binance.com

Query Risk Unit Details (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 Risk Unit Details (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 Weight200

Query Risk Unit Details (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 Risk Unit Details (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

Risk unit unique identifier

Example: 1

Query Risk Unit Details (USER_DATA) › Responses

200

Risk Unit Details

object

groupId

integer · int64

Example: 1

parentEmail

string

Example: andrew.kemmer001@test.com

creditEmail

string

Example: tst20241120@test.com

updateTime

integer · int64

Example: 1752137105623

ltv

string

Example: 0.592

totalNetEquity

string

Example: 26.35196946

totalMaintenanceMargin

string

Example: 0.50106177

totalLiability

string

Example: 15.30718771

parentAccountFrozenAmount

string

Example: 8.18753688

maxTransferOutAmount

string

Example: 0

maxAllowedBorrowLimit

string

Example: 16.32397222

object[]

assetName

string

Example: USDT

principal

string

Example: 15.30718771

interest

string

Example: 0

object[]

email

string

Example: collateral001@test.com

type

string

Example: COLLATERAL

object[]

accountType

string

Example: SPOT

netEquity

string

Example: 5

maintainMargin

string

Example: 0

GET/sapi/v1/margin/loan-group/ltv-details

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/margin/loan-group/ltv-details?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "groupId": 1,
    "parentEmail": "andrew.kemmer001@test.com",
    "creditEmail": "tst20241120@test.com",
    "updateTime": 1752137105623,
    "ltv": "0.592",
    "totalNetEquity": "26.35196946",
    "totalMaintenanceMargin": "0.50106177",
    "totalLiability": "15.30718771",
    "parentAccountFrozenAmount": "8.18753688",
    "maxTransferOutAmount": "0",
    "maxAllowedBorrowLimit": "16.32397222",
    "liabilities": [
      {
        "assetName": "USDT",
        "principal": "15.30718771",
        "interest": "0"
      }
    ],
    "collateralAccounts": [
      {
        "email": "collateral001@test.com",
        "type": "COLLATERAL",
        "wallets": [
          {
            "accountType": "SPOT",
            "netEquity": "5",
            "maintainMargin": "0"
          }
        ]
      }
    ]
  }
]

json

application/json