Exchange Connection Troubleshooting

Common issues and solutions when connecting your exchange to Trading Bot Trading Bot.

🚨 Trading Bot IP Address for Whitelisting

Most connection issues are caused by missing IP whitelisting. Copy this IP address and add it to your exchange API settings:

👆 Click to copy • Required for ALL exchanges

Quick Diagnostic

Before You Start

IP 107.189.19.87 is whitelisted (REQUIRED)
Exchange account is fully verified
API Key was created with trading permissions
Credentials were copied correctly
Exchange is not under maintenance

Test Your Connection

Try these quick tests to isolate the issue:

  1. Test API on exchange's official API documentation
  2. Try connecting with testnet credentials if available
  3. Create a new API Key with minimal permissions
  4. Check exchange status page for known issues

Common Issues & Solutions

IP Whitelist Not Configured

Trading operations fail even with valid API credentials

Common Causes

  • •Trading Bot IP address (107.189.19.87) not added to exchange whitelist
  • •IP whitelist field left empty during API creation
  • •Wrong IP address entered in whitelist
  • •IP restrictions not saved properly on exchange
  • •Exchange requires IP whitelisting for trading operations

Solutions

  • Add 107.189.19.87 to your exchange API whitelist immediately
  • Recreate API key with proper IP whitelisting if needed
  • Double-check the IP address: 107.189.19.87 (copy exactly)
  • Save/confirm IP whitelist settings on your exchange
  • Contact exchange support if IP whitelist options are not visible
  • Verify IP whitelist is active and not in pending status

Invalid API Credentials Error

Connection fails with "Invalid API Key" or "Authentication failed" message

Common Causes

  • •Incorrect API Key or Secret copied from exchange
  • •Extra spaces or characters when copying credentials
  • •API Key has been deleted or regenerated on exchange
  • •Wrong exchange selected in Trading Bot
  • •API Key not activated on exchange side

Solutions

  • Double-check API Key and Secret are copied exactly (no extra spaces)
  • Verify the exchange selection matches where you created the API
  • Generate new API credentials on your exchange
  • Ensure API Key is activated and not in pending status
  • Try copying credentials again using copy button if available
  • Check if API Key has expiration date and renew if needed

Insufficient Permissions Error

API connection succeeds but trading operations fail

Common Causes

  • •API Key created with read-only permissions
  • •Trading permissions not enabled during API creation
  • •Spot trading disabled but futures enabled (or vice versa)
  • •IP restrictions preventing access - missing 107.189.19.87
  • •Account level restrictions (VIP level requirements)

Solutions

  • FIRST: Ensure 107.189.19.87 is whitelisted (most common cause)
  • Recreate API Key with "Spot Trading" and "Futures Trading" permissions
  • Enable all required permissions: Read, Trade, and any bot-specific ones
  • Verify your exchange account has sufficient verification level
  • Contact exchange support if permissions seem correct but still failing
  • Test with a new API Key to rule out permission caching issues

Rate Limit Exceeded

Connection intermittently fails with rate limiting errors

Common Causes

  • •Too many API requests in short time period
  • •Multiple bots or applications using same API Key
  • •Exchange temporarily reducing API limits
  • •High-frequency trading triggering limits
  • •Shared IP address with other Trading Bot users

Solutions

  • Wait 5-10 minutes before retrying connection
  • Use separate API Keys for different applications
  • Reduce trading frequency if using custom strategies
  • Check exchange documentation for current rate limits
  • Consider upgrading exchange account tier for higher limits
  • Contact Trading Bot support if limits seem unusually low

Connection Timeout Issues

API connection times out or fails to establish

Common Causes

  • •Temporary network connectivity issues
  • •Exchange API servers experiencing downtime
  • •Firewall blocking outgoing connections
  • •DNS resolution problems
  • •Exchange maintenance periods

Solutions

  • Check exchange status page for known outages
  • Try connecting again after a few minutes
  • Test your internet connection to other services
  • Try connecting from different network if possible
  • Check if your firewall allows HTTPS connections
  • Wait for exchange maintenance to complete

Testnet/Mainnet Configuration Mismatch

API Key works on exchange but not in Trading Bot

Common Causes

  • •API Key created for testnet but mainnet selected in Trading Bot
  • •API Key created for mainnet but testnet selected in Trading Bot
  • •Exchange doesn't support testnet for API trading
  • •Different API endpoints for testnet vs mainnet

Solutions

  • Verify if your API Key was created for testnet or mainnet
  • Match the testnet/mainnet setting in Trading Bot to your API Key
  • Create separate API Keys for testnet and mainnet if needed
  • Check exchange documentation for testnet API support
  • Start with mainnet if testnet is causing issues
  • Use paper trading mode in Trading Bot for testing instead of testnet

Passphrase Problems (OKX)

OKX connection fails even with correct API Key and Secret

Common Causes

  • •Passphrase not entered or incorrect
  • •Passphrase contains special characters causing issues
  • •Passphrase was changed on exchange but not updated in Trading Bot
  • •Case sensitivity issues with passphrase

Solutions

  • Double-check passphrase is entered exactly as set on OKX
  • Avoid special characters in passphrase when creating API Key
  • Regenerate API Key with simple passphrase (letters and numbers only)
  • Ensure passphrase field is not left empty for OKX
  • Copy passphrase carefully to avoid case sensitivity issues
  • Test passphrase on OKX API documentation page first

Prevention Tips

Use Strong, Unique Passphrases

Create unique passphrases for each exchange API, avoiding common words or patterns.

Enable IP Whitelisting

Restrict API access to specific IP addresses when supported by your exchange.

Monitor API Usage

Regularly check your exchange's API usage logs for unusual activity.

Keep Credentials Secure

Store API keys securely and never share them with unauthorized parties.

Regular Security Audits

Periodically review and rotate your API keys, especially after any security concerns.

Start with Testnet

Test your setup with testnet or paper trading before using real funds.

Still Having Issues?

If you've tried the solutions above and are still experiencing connection problems, our support team is here to help you get connected.

Contact SupportBack to Setup Guide

Pro Tip: Include your exchange name, error message, and steps you've already tried when contacting support for faster resolution.