What is the API Trading Symbol Whitelist function?
The API Trading Symbol Whitelist function lets you restrict sub-accounts’ Spot/Margin trading to the Master Account selected trading pairs only. It aims to further enhance trading security and can achieve more flexible trading management for sub-accounts. This feature is currently available for Spot/Margin trading on Normal sub-accounts only.
Who can use the API Trading Symbol Whitelist function?
Master Accounts with APIs setup for normal sub-accounts can use the API Trading Symbol Whitelist function. Once you have configured the symbol whitelist, the selected sub-accounts can only trade whitelisted pairs through API. However, if they are trading on the Binance website, there will be no symbol restrictions.
For more information about sub-accounts, please refer to How to Manage Sub-Account Functions and Frequently Asked Questions.
What are the features of the API Trading Symbol Whitelist function?
- Restrict Spot/Margin trading to selected pairs only. This allows trading teams to assign selected pairs to specific traders;
- Enhanced API trading security. In case your APIs are stolen, unauthorized third-parties cannot deal on trading pairs that are not on the whitelist;
- User-friendly interface. Trading teams could easily find and select trading pairs to whitelist. It supports up to 30 pairs for each sub-account API.
Currently, the API Trading Symbol Whitelist function is available for Spot/Margin trading on Normal sub-accounts only. We will support more products and other sub-account types in the future.
How to enable and configure the API Trading Symbol Whitelist from the Master Account?
1. Log in to your Binance account and click [Profile] - [Sub Accounts].
2. Navigate to [API Management] on the left and find the sub-account you want to enable symbol whitelist. Click [Modify] next to it.
3. You’ll be redirected to the API Management page. Click [Modify]. Then check the box next to [Enable Symbol Whitelist] to enable the API Trading Symbol Whitelist function.
4. Click [Edit] next to [Enable Symbol Whitelist] to configure the whitelist pairs.
5. You can click [Import from favorites] and your favorite trading pairs will be shown. Simply click [+] next to the trading pairs to whitelist.
6. Alternatively, you can select [Custom add] to manually add trading pairs to the whitelist. Click on the first dropdown menu to search for the base currency and the second dropdown menu to search for the quoted currency. By default, the quote currency is set as BNB.
You can also click [ALTS] or [FIAT] to search for other quote currencies.
Please note that you can only add a maximum of 30 pairs for each sub-account API.
7. When you finish selecting the pairs, click [Save].
You may click [Edit] to review the whitelisted pairs. Once confirmed, click [Save] on the [API Management] page.
8. You need to verify the request with 2FA verification.
9. You will see that the [Enable Symbol Whitelist] box is now checked, meaning you’ve enabled the function and this sub-account can only trade the selected pairs in the Spot/Margin markets with API.
How to disable the API Trading Symbol Whitelist from the Master Account?
1. Go to [API Management] from the Master Account. Click [Modify] next to the sub-account you want to disable the function.
2. Click [Modify] and uncheck the box next to [Enable Symbol Whitelist]. Then click [Save].
3. You need to verify the request with 2FA verification.
4. You will now see that the box next to [Enable Symbol Whitelist] is unchecked, meaning that the function is disabled.
