Frequently Asked Questions on Margin Special API Key

Published on 2023-07-11 03:22

Updated on 2026-05-14 22:04

Overview & Eligibility

1. What is the Margin Special API Key?

The Margin Special API Key is designed for margin trading, offering low-latency connectivity similar to spot trading. It allows traders to efficiently utilize their assets on Binance Margin.

Feature	Margin Special API Key	Normal API Key
Specialty	Lower latency as orders are placed via spot endpoints. Traders can enjoy the same level of low latency as spot trading on Binance Margin.	Higher latency as orders are processed via margin endpoints.
Function	Used for placing orders.	Supports order placement, automatic borrowing, and repayments.
Compatibility	Cross Margin Isolated Margin Portfolio Margin Pro Unsupported Products: Portfolio Margin	Portfolio Margin Program Portfolio Margin Pro Program Cross and Isolated Margin
Availability	VIP 7 - 9 users Regular, and VIP 1 - 6 users who qualify for one of the three categories as per our review: Market makers High frequency traders High margin volume traders	All users
Requirements	Binance users who: Have completed identity verification and proof of address. Do not reside in a Binance margin trading-restricted country/region.

2. Who can access the Margin Special API Key?

For VIP 7 and above:
The Margin Special API Key is available to VIP 7 and above users who aren’t residing in margin trading-restricted countries or regions.
For VIP 6 and below:
If you are a VIP 6 or lower tier user and qualify as a market maker, high-frequency trader, or high volume trader, please contact your VIP Manager for potential access.

Eligible accounts are:

Cross Margin Classic
Isolated Margin
Portfolio Margin Pro

3. What happens if I move to a country where margin trading is restricted?

Your access to the Margin Special API Key will be revoked.

Getting Started

4. How to create a Margin Special API Key?

If you meet the above requirements, please contact your VIP Manager to learn more about creating a Margin Special API Key. Note that a Margin Special Key Supplemental Product Terms must be signed before a Margin Special Key can be created on your account.

5. Who needs to sign the Supplement Agreement?

All new Margin Special Key users. The agreement is signed at the master account level and binds all of your Binance accounts and sub-accounts. Once signed:

The master account and all sub-accounts (Cross Margin Classic and Portfolio Margin Pro) are authorized to create a Margin Special Key.
All accounts that have created a Margin Special Key are subject to the LiquidationLoan policy. This means that if a forced liquidation on a Cross Margin Classic account with an active Margin Special Key results in a deficit, the deficit amount will be represented as a USDC loan. Trading and borrowing will be disabled on the affected account until the outstanding liability is fully repaid via API.

6. If I sign at the master account level, does that mean all my sub-accounts are affected?

Yes. Signing at the master level authorizes Margin Special Key creation across all sub-accounts and brings all Cross Margin Classic and Portfolio Margin Pro sub-accounts with active Margin Special Keys under the LiquidationLoan framework.

7. How many Margin Special API Keys can I own?

You can create up to 30 API keys per Binance account, including both normal and special keys.

Technical Usage

8. Which endpoints are compatible with the Margin Special API Key?

The Margin Special API Key is only applicable with “/api” endpoints. It is strongly recommended not to use this key for “/sapi” endpoints.

9. How can I borrow assets on margin using a Margin Special API Key?

You can only use the Margin Special API Key to place orders. For margin borrowings, please utilize the standard API key.

Liquidation & Risk

10. What happens if an account with an active Margin Special Key is liquidated?

If a forced liquidation on an account with a Margin Special Key results in a net deficit, the deficit is handled according to the account type (see Q11 below).

11. When will a LiquidationLoan be created? (Scope)

The outcome depends on whether a Margin Special Key has been created on the account:

Account Type	Margin Special Key Status	Will a LiquidationLoan be created if the margin account is in deficit?	Logic
Cross Margin Classic	Margin Special Key created AND Margin Special Key exit status has not been confirmed by Binance via api	Yes	If a net deficit remains after liquidation, the deficit is represented by a LiquidationLoan on the user’s account. The user is responsible for repayment of the deficit in full.
Cross Margin Classic	No Margin Special Key created OR The account previously had a Margin Special Key created but Binance has since confirmed that account has exited Margin Special Key status.	No	Standard liquidation logic for Cross Margin Classic mode applies.
Portfolio Margin Pro Account	-	Yes	Follows existing Portfolio Margin Pro Account logic (for more details, please refer to this article).
Isolated Margin	-	No	Standard liquidation logic for Isolated Margin mode applies.

Exit & Key Management

12. How do I exit the Margin Special Key framework?

There are two steps:

Delete your Margin Special Key — you may do this at any time.
Call the dedicated "Exit Margin Special Key" API — only after Binance confirms successful exit via API response will your account revert to standard liquidation logic and no longer be subject to the Supplemental Product Terms.

⚠️ Deleting the key alone is not enough. Until the exit API call is completed and confirmed, your associated margin accounts remain bound by the Supplemental Product Terms and the LiquidationLoan policy.

13. If I delete my Margin Special API Key, am I still bound by the Supplemental Product Terms?

No — deleting the key alone does not discharge your obligations. You remain subject to the Supplemental Product Terms until you complete the full exit via the dedicated "Exit Margin Special Key" API and receive confirmation from Binance.

14. Will my Margin Special API Key be deleted due to inactivity?

Your Margin Special API Key may stay active despite periods of inactivity; however, Binance reserves the right, in its sole and absolute discretion, to revoke access at any time if the key is deemed by Binance, to be inactive. Please watch for email notifications regarding any such updates.

To learn more, please visit the Margin API Functions FAQs page.