SignalBee
Docs/Exchange Guides

Gate.io Exchange Setup

Connect your Gate.io 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 Gate.io account - Identity verification (KYC) completed
  • 2FA enabled on Gate.io - Required for API key creation
  • SignalBee account - Ready to connect an exchange
  • Password manager - For storing your API credentials securely

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


About Gate.io

Gate.io is a global cryptocurrency exchange known for its extensive altcoin selection and competitive fees. Key highlights:

  • Wide altcoin selection - One of the largest selections of altcoins available
  • Competitive fees - 0.2% maker/taker fees on spot (GT token discounts available)
  • GT token discounts - Hold GT tokens to reduce trading fees
  • Testnet available - Test your integration before trading with real funds
  • Multiple account types - Supports spot, margin, and futures trading
  • Strong API documentation - Well-documented REST API with v4 endpoints

Creating Your API Key

Follow these steps to create an API key on Gate.io:

Step 1: Log In to Gate.io

  1. Go to www.gate.io
  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 Key button
  2. You'll be presented with the API configuration screen

Step 4: Enter a Label

  1. Enter a descriptive label: SignalBee Trading
  2. 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 5: Configure Permissions

  1. Check the permission boxes as described in the Configuring Permissions section below
  2. Enable Read Only and Spot Trade permissions
  3. Never enable the Withdrawal permission

Step 6: IP Whitelist (Optional)

  1. You can optionally restrict the API key to specific IP addresses
  2. See the IP Whitelist Configuration section below
  3. For initial setup, you can skip this and add later

Step 7: Complete Security Verification

  1. Enter your 2FA code from your authenticator app
  2. Complete any additional verification (email, SMS) if prompted
  3. Click Confirm to create your key
  4. Your credentials will be displayed

⚠️ Copy Your Keys IMMEDIATELY:

KeyCan View Later?Action Required
API Key✅ YesCopy and save
Secret KeyNO - Never shown againCopy immediately!

Warning: If you navigate away 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

Gate.io has a straightforward permission system. This is critical for security.

Required Permissions

PermissionEnable?Why
Read Only✅ YesAllows SignalBee to check your balances and account info
Spot 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.
Futures Trade❌ NoNot needed for spot trading with SignalBee
Transfer❌ NoNot needed for SignalBee trading
Sub-Account❌ NoNot needed unless specifically using sub-accounts

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

Simple Two-Value System

Gate.io uses a straightforward credential system:

ExchangeCredential Model
Gate.ioTwo values: API Key + Secret Key
OKXThree values: API Key + Secret Key + Passphrase
KuCoinThree values: API Key + Secret Key + Passphrase

This makes Gate.io simpler to configure than some exchanges.


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 next to the key
  3. Enable IP Address Restriction
  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 Gate.io 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 Gate.io from the exchange list

Step 3: Enter Your Credentials

Gate.io uses a simple two-value API system:

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

Note: Gate.io requires only 2 credentials (API Key + Secret Key). This is simpler than exchanges like OKX or KuCoin that require an additional 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 Gate.io balances should appear in SignalBee
  2. Check that your expected assets are listed
  3. Balances confirm the Read Only permission is working

Tip: If balances don't appear, verify that Read Only permission is enabled on your API key.


Gate.io-Specific Considerations

Ticker Format

Gate.io uses underscore-separated ticker symbols internally. SignalBee handles the conversion automatically:

SignalBee FormatGate.io Format
BTC-USDTBTC_USDT
ETH-USDTETH_USDT
XRP-USDTXRP_USDT
SOL-USDTSOL_USDT

Your webhook symbols use SignalBee's standard hyphen format (BTC-USDT). SignalBee automatically converts these to Gate.io's underscore format (BTC_USDT) when communicating with the exchange.

Note: You don't need to change your webhook format—SignalBee handles the conversion.

Supported Order Types

Gate.io spot trading supports the following order types:

Order TypeSupportedNotes
Market Order✅ YesExecutes immediately at best available price
Limit Order✅ YesExecutes at specified price (supports GTC, IOC, FOK)
Stop-Loss❌ NoNot available via spot API
Take-Profit❌ NoNot available via spot API
Trailing Stop❌ NoNot supported

Important: Gate.io's spot API does not support stop-loss or take-profit orders. If your trading strategy requires these order types, they must be managed at the strategy level rather than as native exchange orders. Consider using a market or limit order when your signal fires instead.

Time-in-Force Options (Limit Orders)

OptionDescription
GTCGood Till Cancelled - remains open until filled or cancelled
IOCImmediate or Cancel - fills immediately or cancels unfilled portion
FOKFill or Kill - must fill entirely immediately or cancel completely

Account Types

Gate.io offers multiple account types:

AccountPurpose
SpotSpot trading (use this with SignalBee)
MarginMargin trading
FuturesPerpetual/delivery futures
OptionsOptions trading

SignalBee connects to your Spot account for trading.

Wide Altcoin Selection

Gate.io is known for listing a wide variety of altcoins, often including newer projects before other major exchanges. When using SignalBee:

  • Check that your desired trading pairs are available on Gate.io
  • Verify pair availability in Gate.io's spot market before setting up webhooks
  • Some pairs may have lower liquidity—be aware of potential slippage

Minimum Order Sizes

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

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

Tip: Check Gate.io's trading rules for current minimum order sizes for specific pairs. Gate.io generally has competitive minimums.

Trading Fees

Fee TypeRate
Maker0.2%
Taker0.2%

Fee Discounts:

  • GT Token Holders - Holding GT tokens provides fee discounts
  • VIP Tiers - Higher trading volume unlocks lower fees
  • Check Gate.io's fee schedule for current VIP tier discounts

Tip: If you trade frequently, consider holding some GT tokens to reduce your trading fees.

API Rate Limits

Gate.io applies rate limits to protect the API:

Endpoint TypeLimit
Public endpoints600 requests / 10 seconds
Private endpoints300 requests / 10 seconds
Order endpoints100 requests / 10 seconds
  • SignalBee handles rate limiting automatically
  • If you see rate limit errors, reduce your signal frequency or check for duplicate webhooks
  • Rate limit information is available in response headers

Testnet Available

Good News: Gate.io offers a testnet environment for testing your integration before trading with real funds.

EnvironmentAPI Endpoint
Productionhttps://api.gateio.ws/api/v4
Testnethttps://fx-api-testnet.gateio.ws/api/v4

Testing Approach:

  1. Create a testnet account at Gate.io's testnet site
  2. Generate testnet API credentials
  3. Test your webhooks and order flow with testnet
  4. Once satisfied, switch to production credentials

Tip: Using the testnet is strongly recommended before going live, especially when testing new trading strategies.

Time Synchronization

Gate.io requires synchronized timestamps for API requests. Key details:

  • Gate.io timestamps use seconds (not milliseconds like some exchanges)
  • SignalBee automatically synchronizes with Gate.io's server time
  • If you see timestamp errors, they typically resolve automatically

Troubleshooting

Common Gate.io-specific errors and solutions:

ErrorLabelLikely CauseSolution
Invalid SignatureINVALID_SIGNATUREIncorrect Secret KeyRe-copy the Secret Key carefully. If lost, create new key.
Invalid API KeyINVALID_KEYWrong key, deleted, or lacks permissionsRe-copy API key. Verify key exists and has required permissions.
Insufficient BalanceBALANCE_NOT_ENOUGHNot enough funds for orderDeposit funds or reduce order size.
Insufficient BalanceINSUFFICIENT_BALANCENot enough funds (alternate)Deposit funds or reduce order size.
Invalid SymbolINVALID_CURRENCY_PAIRWrong trading pair formatSignalBee converts automatically. Verify pair exists on Gate.io.
Invalid SymbolINVALID_SYMBOLInvalid trading pair (alternate)Verify pair is listed on Gate.io spot market.
Order Value Too SmallTOTAL_TOO_LITTLEOrder value below minimum notionalIncrease order size above minimum.
Quantity Too SmallORDER_SIZE_TOO_SMALLQuantity below pair minimumIncrease quantity.
Quantity Too SmallAMOUNT_TOO_LITTLEQuantity below minimum (alternate)Increase quantity.
Quantity Too LargeORDER_SIZE_TOO_LARGEQuantity exceeds maximumDecrease quantity.
Quantity Too LargeAMOUNT_TOO_MUCHQuantity exceeds maximum (alternate)Decrease quantity.
Price Too LowPRICE_TOO_LOWLimit price below allowed minimumIncrease your limit price.
Price Too HighPRICE_TOO_HIGHLimit price exceeds maximumDecrease your limit price.
Order Not FoundORDER_NOT_FOUNDInvalid order IDOrder may have been filled or cancelled already.
Already FilledORDER_ALREADY_FILLEDTrying to cancel filled orderOrder completed successfully—no action needed.
Invalid ParametersINVALID_PARAM_VALUEInvalid order parametersCheck order values (quantity, price, side).
Invalid PrecisionINVALID_PRECISIONToo many decimal placesReduce decimal precision in quantity or price.
Rate Limit ExceededRATE_LIMIT_EXCEEDEDToo many API requestsWait and retry. Reduce request frequency.

Note: Gate.io uses string labels (like INVALID_SIGNATURE) for error codes, not numeric codes. This makes errors easier to understand at a glance.

Connection Test Fails?

If your connection test fails in SignalBee:

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

HMAC-SHA512 Authentication

Gate.io uses HMAC-SHA512 for request signing (not SHA256 like some exchanges). SignalBee handles this automatically, but if you're debugging:

  • Gate.io signatures are 128 characters (hex-encoded SHA512)
  • Timestamps are in seconds, not milliseconds
  • Headers used: KEY, Timestamp, SIGN

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


Security Best Practices

Follow this checklist to keep your Gate.io account secure:

Gate.io Account Security

  • Enable 2FA with Google Authenticator - more secure than SMS
  • Use a unique, strong password for Gate.io (not reused from other sites)
  • Enable email notifications for account activity
  • Review login history regularly for unauthorized access
  • Consider enabling anti-phishing code in security settings

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 Gate.io - delete any you don't recognize
  • Rotate API keys every 90 days as a security habit
  • Monitor trade history on Gate.io for any unauthorized activity
  • Review API key permissions periodically to ensure they're still appropriate

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