Skip to main content

Why do I get the error Symbol not whitelisted for API key on Binance?

This error is related to Binance's API Trading Symbol Whitelist on sub-accounts. Here's how to enable and configure it.

Written by Pete Darby
Updated over 2 weeks ago

What this error means

This error appears when you're using Binance sub-accounts. Binance's API Trading Symbol Whitelist restricts a sub-account's Spot/Margin API trading to a set of pairs selected by the Master Account. If your bot tries to trade a pair that isn't on the whitelist, you'll see this error.

How to configure the Symbol Whitelist

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 the symbol whitelist for and 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].

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. You can add up to 30 pairs per 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

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

6. Click [Import from favorites] to see your favorite trading pairs and add them to the whitelist.

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

7. To remove a pair from the whitelist, click [Remove] or [x] next to it. When you're done selecting 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

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

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

You'll see that the [Enable Symbol Whitelist] box is now checked. This sub-account can now only trade the selected pairs in Spot/Margin markets via 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

About the API Trading Symbol Whitelist

The API Trading Symbol Whitelist lets you restrict sub-accounts' Spot/Margin trading to Master Account-selected pairs only. It's available to Master Accounts that have APIs set up for normal sub-accounts.

Here's what it offers:

  • Flexible trading management — Trading teams can assign specific pairs to specific traders by configuring the whitelist per sub-account.

  • Enhanced security — If your API keys are ever compromised, unauthorized parties can't trade pairs that aren't on the whitelist.

  • Easy configuration — Trading teams can easily find and select trading pairs to whitelist. Each sub-account API supports up to 30 pairs.

Keep in mind: the whitelist only affects API trading. Sub-accounts can still trade any pair directly on the Binance website. The feature is currently available for Spot/Margin trading on normal and managed sub-accounts only.

For more information about sub-accounts, see How to Manage Sub-Account Functions and Frequently Asked Questions.

Did this answer your question?