SignalBee
Docs/Exchange Guides

Bitrue Exchange Setup

Connect your Bitrue account to SignalBee in minutes. This guide walks you through creating and configuring API keys with the exact permissions needed for automated trading.


Prerequisites

Before you begin, make sure you have:

  • Verified Bitrue account - Identity verification (KYC) completed
  • 2FA enabled on Bitrue - Required for API key creation
  • SignalBee account - Ready to connect an exchange
  • Password manager - For storing your API credentials securely

Security Note: Bitrue requires 2FA (two-factor authentication) to create API keys. If you haven't enabled 2FA yet, go to Security SettingsGoogle Authentication in your Bitrue account settings.


Creating Your API Key

Follow these steps to create an API key on Bitrue:

Step 1: Log In to Bitrue

  1. Go to www.bitrue.com
  2. Log in with your email and password
  3. Complete 2FA verification if prompted

Step 2: Navigate to API Management

  1. Click your profile icon in the top-right corner
  2. Select API Management from the dropdown menu
  3. You'll see a list of your existing API keys (if any)

Step 3: Create a New API Key

  1. Click the Create API button
  2. Enter a descriptive label: SignalBee Trading
  3. A clear label helps you identify this key's purpose later

Tip: Use specific labels like "SignalBee-Spot" or "SignalBee-Main" if you plan to create multiple keys for different purposes.

Step 4: Configure Permissions

  1. Check the permission boxes as described in the Configuring Permissions section below
  2. Ensure only Read and Trade are enabled
  3. Leave Withdraw unchecked

Step 5: Complete Security Verification

Bitrue requires verification steps to confirm API creation:

  1. Google Authenticator - Enter the 6-digit code from your authenticator app
  2. Email Verification - Enter the verification code sent to your registered email
  3. Wait for verification to complete

Step 6: Copy Your Keys IMMEDIATELY

After verification, Bitrue displays your API credentials:

  • API Key - Can be viewed later in your API Management page
  • Secret Key - ⚠️ Shown only ONCE - Copy it immediately!
KeyCan View Later?Action Required
API Key✅ YesCopy and save
Secret KeyNO - Never shown againCopy immediately!

Warning: If you close this page without copying your Secret Key, you'll need to delete this API key and create a new one. There is no way to recover a Secret Key.

Save both keys in your password manager now before proceeding.


Configuring Permissions

API permissions control what actions SignalBee can perform on your account. This is critical for security.

Required Permissions

PermissionEnable?Why
Read✅ YesAllows SignalBee to check your balances and account info
Trade✅ YesAllows SignalBee to place and manage spot orders

Never Enable These Permissions

PermissionEnable?Why
WithdrawNEVERSignalBee never needs withdrawal access. Enabling this is a serious security risk.

Security Note: Even if your API key is somehow compromised, funds cannot be withdrawn without withdrawal permissions enabled. This is your most important security protection.

How to Edit Permissions

If you need to modify permissions on an existing key:

  1. In API Management, find your SignalBee API key
  2. Click Edit next to the key
  3. Check/uncheck the permission boxes as shown above
  4. Click Save
  5. Complete 2FA verification to confirm changes

IP Whitelist Configuration

IP whitelisting restricts your API key to only work from specific IP addresses. This is optional but adds a strong security layer.

Why Use IP Whitelisting?

ScenarioWithout WhitelistWith Whitelist
SignalBee places trade✅ Works✅ Works
Attacker tries stolen key⚠️ Could work❌ Blocked

Even if your API key is somehow exposed, it won't work from unauthorized IP addresses.

SignalBee Server IP Addresses

Note: Contact support@signalbee.trade to request SignalBee's current production IP addresses for whitelisting. We maintain static IPs specifically for exchange API calls and will notify you before any infrastructure changes.

How to Configure IP Whitelisting

  1. In API Management, find your SignalBee API key
  2. Click Edit or access the IP restriction settings
  3. Enable IP Restriction or Trusted IP option
  4. Enter each SignalBee IP address provided by support
  5. Click Save
  6. Complete 2FA verification if prompted

If You Skip IP Whitelisting

If you choose not to use IP whitelisting:

  1. Leave IP restrictions disabled
  2. Understand this is less secure but still safe if withdrawals are disabled
  3. Your other security measures (no withdrawal permission) still protect your funds

Adding to SignalBee

Now connect your Bitrue API key to SignalBee:

Step 1: Go to Exchanges Page

  1. Log in to your SignalBee account
  2. Navigate to Exchanges in the main menu

Step 2: Add New Exchange

  1. Click the Add Exchange button
  2. Select Bitrue from the exchange list

Step 3: Enter Your Credentials

Bitrue uses a simple two-value API system:

  1. API Key - Paste your Bitrue API key
  2. Secret Key - Paste your Bitrue Secret key
  3. Label (optional) - Enter a name like "Bitrue Main Account"

Note: Bitrue requires only 2 credentials (API Key + Secret Key). This is simpler than some other exchanges that require additional fields like a passphrase.

Step 4: Test the Connection

  1. Click Save and Test Connection
  2. Wait for SignalBee to verify your credentials
  3. Look for the ✅ success message

Step 5: Verify Your Setup

After successful connection:

  1. Your Bitrue balances should appear in SignalBee
  2. Check that your expected assets are listed
  3. Balances confirm the Read permission is working

Tip: If balances don't appear, verify that Read permission is enabled in your Bitrue API settings.


Bitrue-Specific Considerations

Ticker Format

Bitrue uses concatenated ticker symbols without separators (same format as Binance):

SignalBee FormatBitrue Format
BTC/USDTBTCUSDT
ETH/USDTETHUSDT
XRP/USDTXRPUSDT

SignalBee handles this conversion automatically. When configuring your webhooks or whitelists, you can use either format.

Supported Order Types

Bitrue spot trading supports the following order types:

Order TypeSupportedNotes
Market Order✅ YesExecutes immediately at best available price
Limit Order✅ YesExecutes at specified price or better
Stop Order❌ NoNot available on Bitrue spot trading

Note: If your trading strategy requires stop-loss or take-profit orders as separate order types, these must be managed at the strategy level rather than as native exchange orders.

Minimum Order Sizes

Bitrue enforces minimum order values. Orders below these minimums will be rejected:

Trading PairMinimum Notional Value
Most USDT pairsVaries by pair
Most BTC pairsVaries by pair

Tip: Check Bitrue's trading rules for current minimum order sizes for specific pairs.

Trading Fees

Fee TypeStandard Rate
MakerCheck Bitrue for current rates
TakerCheck Bitrue for current rates

Tip: Bitrue offers competitive trading fees. Check their fee schedule for the most current rates and any VIP tier discounts based on trading volume.

API Rate Limits

  • Bitrue imposes rate limits on API requests
  • SignalBee handles rate limiting automatically
  • If you see rate limit errors, reduce your signal frequency or check for duplicate webhooks

No Testnet Available

Unlike some exchanges, Bitrue does not offer a testnet or sandbox environment. All API testing occurs on the live production environment.

Tip: Start with small order sizes when first testing your SignalBee integration with Bitrue.

Binance Compatibility

Bitrue uses a Binance-compatible API, which means:

  • Similar authentication method (HMAC-SHA256 signatures)
  • Familiar error codes and response formats
  • Consistent ticker format
  • If you're familiar with Binance, Bitrue will feel similar

Troubleshooting

Common Bitrue-specific errors and solutions:

ErrorCodeLikely CauseSolution
Rate Limit Exceeded-1003Too many API requestsWait a few seconds and retry. Reduce signal frequency if persistent.
Invalid Timestamp-1021Clock synchronization issueUsually temporary. SignalBee handles time sync automatically. Wait and retry.
Invalid Signature-1022Incorrect Secret KeyRe-copy the Secret Key carefully. If lost, delete the API key and create a new one.
Invalid API Key Format-2014Malformed API keyRe-copy the API key. Check for extra spaces or missing characters.
Invalid API Key-2015Key deleted or typoVerify key exists in Bitrue API Management. Re-copy if needed.
Insufficient Balance-2010Not enough fundsTransfer funds to your spot wallet or reduce order size.
Order Not Found-2013Invalid order IDOrder may have been filled or cancelled. Check order history.
Filter Failure-1013Below minimum or price filterIncrease order quantity or adjust price to meet exchange requirements.
HTTP 429-Rate limitedWait and retry. Reduce request frequency.
HTTP 418-IP banned temporarilyWait or contact Bitrue support if persistent.

Connection Test Fails?

If your connection test fails in SignalBee:

  1. Double-check both keys - Copy-paste errors are the most common issue
  2. Wait a few minutes - New API keys may take 1-2 minutes to activate
  3. Verify permissions - Ensure Read permission is enabled
  4. Check IP whitelist - Disable IP restriction temporarily to test
  5. Check Bitrue status - Verify Bitrue is not under maintenance

For persistent issues, see our Error Codes Reference or contact support@signalbee.trade.


Security Best Practices

Follow this checklist to keep your Bitrue account secure:

Bitrue Account Security

  • Enable 2FA with Google Authenticator - more secure than SMS
  • Use a unique, strong password for Bitrue (not reused from other sites)
  • Enable email notifications for account activity
  • Review login history regularly for unauthorized access

API Key Security

  • Create a dedicated API key just for SignalBee - don't reuse keys across services
  • Never enable withdrawal permission - SignalBee never needs it
  • Consider IP whitelisting for maximum security
  • Never share your Secret Key via email, chat, or screenshots
  • Store keys in a password manager (1Password, Bitwarden, etc.)

Ongoing Security

  • Review your API keys periodically in Bitrue - delete any you don't recognize
  • Rotate API keys every 90 days as a security habit
  • Monitor trade history on Bitrue for any unauthorized activity
  • Keep your email secure - it's used for Bitrue account recovery

Security Note: Even with all these precautions, the most important protection is never enabling withdrawal permissions. Without this permission, your funds cannot be moved off the exchange even if everything else is compromised.