Binance API Keys (Global)

Connect your Binance account to TraderBotz using the Spot Trading REST API. Your bots will be able to view market data and execute spot trades across Binance's full instrument catalogue.

Important: Binance (global) is for non-US users. If you are based in the United States, use Binance.US instead. TraderBotz encrypts all credentials at rest with Fernet symmetric encryption.

Step 1: Open Binance API Management

Log in to binance.com/en/my/settings/api-management and click Create API.

Step 2: Create an API Key

  1. 1 Select System generated as the API key type
  2. 2 Give the key a label (e.g., "TraderBotz")
  3. 3 Complete the 2FA verification when prompted

Step 3: Configure Permissions

Click Edit restrictions on the newly created key and enable:

  • Enable Reading — Required for balance and market data queries
  • Enable Spot & Margin Trading — Required for placing buy/sell orders
  • Enable Withdrawals — Not needed (leave unchecked)
  • Enable Futures — Not needed

Tip: For extra security, restrict the API key to specific IP addresses. Binance supports IP whitelisting under the key's security settings.

Step 4: Copy Your Credentials

After saving the permissions, Binance will display your credentials:

API Key

A long alphanumeric string. Copy it to your clipboard.

Secret Key

Shown only once. Copy and save it securely — Binance will not show it again.

Save the secret key immediately. Binance only shows it once. If you lose it, you'll need to delete the key and create a new one.

Step 5: Add to TraderBotz

  1. 1 In TraderBotz, go to Accounts in the sidebar
  2. 2 Click Add Account and select Binance (Global) from the dropdown
  3. 3 Enter a name (e.g., "My Binance")
  4. 4 Paste the API Key
  5. 5 Paste the Secret Key
  6. 6 Click Test Connection to verify everything works
  7. 7 Save the account — it's now available when creating bots

Quote currency note: Binance global primarily uses USDT as the quote currency. When creating a bot, TraderBotz will default to USDT for Binance accounts to ensure your instrument presets match available trading pairs.

Troubleshooting

"Invalid API key" error

Double-check that you copied the full API key and secret key. Make sure there are no leading or trailing spaces.

"Permission denied" on trade

Verify that Enable Spot & Margin Trading is checked in the API key restrictions on Binance.

IP restriction error

If you enabled IP restrictions on Binance, make sure the TraderBotz server's public IP (or your self-hosted node IP) is in the allowed list.