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 Select System generated as the API key type
- 2 Give the key a label (e.g., "TraderBotz")
- 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 In TraderBotz, go to Accounts in the sidebar
- 2 Click Add Account and select Binance (Global) from the dropdown
- 3 Enter a name (e.g., "My Binance")
- 4 Paste the API Key
- 5 Paste the Secret Key
- 6 Click Test Connection to verify everything works
- 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.