Skip to main content
All CollectionsTrading 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 2 months 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].

Cryptohopper troubleshooting guide: Binance profile menu showing Sub Accounts option for API whitelist configuration, with navigation path through Profile icon to resolve Symbol not whitelisted trading bot error

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.

"Cryptohopper troubleshooting guide: Binance API Management page for sub-accounts showing API keys list with Modify button highlighted, demonstrating how to resolve Symbol not whitelisted error for trading bot configuration

3. You’ll be redirected to the API Management page. Click [Modify]. Then check the box next to [Enable Symbol Whitelist].

Cryptohopper setup guide: Binance API Management modification panel showing 'Enable Symbol Whitelist' checkbox with Edit button, featuring API security settings and restrictions for automated trading bot configuration

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.

Cryptohopper configuration guide: Binance Spot & Margin Symbol Whitelist modal showing BTC trading pairs selection with Add/Remove options, search functionality, and 30-pair limit notice for trading bot API setup

You can also view the most popular pairs. Click [Add] to add a pair to the whitelist.

Cryptohopper integration guide: Binance Symbol Whitelist top trading pairs view showing BTC/USDT, SOL/USDT, XRP/USDT, BNB/USDT, and ETH/USDT with Add buttons for automated trading bot configuration

5. You can click [Import from favorites] and your favorite trading pairs will be shown.

Cryptohopper setup guide: Binance Symbol Whitelist configuration showing 'Import from favorites' tab with added pairs BTC/USDT and BTC/BUSD, demonstrating favorite trading pairs import for automated trading bot

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].

Cryptohopper configuration guide: Binance Symbol Whitelist management showing Remove button and 'x' deletion options for trading pairs, with Confirm button to save whitelist changes for automated trading bot setup

7. You may click [Edit] again to review the whitelisted pairs. Once confirmed, click [Save] on the [API Management] page.

Cryptohopper API setup guide: Binance API Management final configuration screen with Save button highlighted, showing enabled Symbol Whitelist and API restrictions for automated trading bot integration

8. Verify the request with 2FA.

Cryptohopper security setup: Binance API Management security verification modal showing 2-step verification requirements with Authenticator App and Email options (0/2 completed) for trading bot API configuration

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.

Cryptohopper integration complete: Binance API Management page showing successfully enabled Symbol Whitelist checkbox with restricted trading permissions for automated trading bot, confirming Spot and Margin trading pair limitations

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?