How to Whitelist API Trading Symbol for Sub-Accounts?

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.