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 and managed 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 and managed sub-accounts only.
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. Go to [API Management] under [Sub Accounts] on the left. 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].
4. Click [Edit] next to [Enable Symbol Whitelist] to configure the whitelist pairs. You can search for symbol pairs here. Click [Add] to add a pair to the whitelist.
Please note that you can only add a maximum of 30 pairs for each sub-account API.
You can also view the most popular pairs. Click [Add] to add a pair to the whitelist.
5. You can click [Import from favorites] and your favorite trading pairs will be shown.
6. If you want to remove a symbol pair from the whitelist, click [Remove] or [x] next to it.
When you finish selecting the pairs, click [Confirm].
7. You may click [Edit] again to review the whitelisted pairs. Once confirmed, click [Save] on the [API Management] page.
8. Verify the request with 2FA.
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. Log in to your master account and go to [Sub Account] - [API Management]. 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. Verify the request with 2FA.
4. You'll see that the box next to [Enable Symbol Whitelist] is unchecked, meaning that the function is disabled.
