All Collections
Trading Errors & Troubleshooting
Why do I get the error Symbol not whitelisted for API key on Binance?
Why do I get the error Symbol not whitelisted for API key on Binance?

Error "Symbol not whitelisted" on Binance? Enable API Trading Symbol Whitelist in your sub-account settings.

Pete Darby avatar
Written by Pete Darby
Updated over a week ago

When you see the error "Symbol not whitelisted" in your Binance trading bot output, you are most likely using sub-accounts.

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.

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.

Did this answer your question?