Bybit Perpetual Futures Setup
Connect your Bybit Futures account to SignalBee for automated perpetual contract trading. This guide walks you through creating API keys with the correct permissions and configuring your account for automated signals.
Important: Bybit requires only two values for API authentication: API Key and Secret Key. Unlike some exchanges (Bitget, KuCoin, OKX), Bybit does NOT require a passphrase.
Prerequisites
Before you begin, make sure you have:
- Verified Bybit account - Identity verification (KYC) completed
- 2FA enabled on Bybit - Required for API key creation
- SignalBee account - Ready to connect an exchange
- Password manager - For storing your API credentials securely
Security Note: Bybit requires 2FA (two-factor authentication) to create API keys. If you haven't enabled 2FA yet, go to Account & Security → Two-Factor Authentication in your Bybit account.
About Bybit Futures
Bybit is a major cryptocurrency derivatives exchange offering USDT-margined perpetual contracts:
| Feature | Details |
|---|---|
| Contract Type | USDT-margined perpetual contracts (Linear) |
| Leverage | Up to 100x (varies by symbol) |
| Order Types | Market, Limit, Stop-Loss, Take-Profit |
| Position Modes | One-way (merged) or Hedge (long + short simultaneously) |
| Margin Types | Cross (shared) or Isolated (per position) |
| Funding Rate | Every 8 hours |
| Trading Fees | Maker 0.01%, Taker 0.06% |
| Testnet | Available at api-testnet.bybit.com |
Order Type Support
SignalBee supports most Bybit Futures order types:
| Order Type | Supported | Bybit API Type | Description |
|---|---|---|---|
| Market | ✅ Yes | orderType: "Market" | Immediate execution at current price |
| Limit | ✅ Yes | orderType: "Limit" | Execute at specified price or better |
| Stop-Loss | ✅ Yes | Market + triggerPrice | Market order when trigger price is reached |
| Stop-Loss Limit | ✅ Yes | Limit + triggerPrice | Limit order when trigger price is reached |
| Take-Profit | ✅ Yes | Market + triggerPrice | Market order when take-profit price is reached |
| Take-Profit Limit | ✅ Yes | Limit + triggerPrice | Limit order when take-profit price is reached |
| Trailing Stop | ❌ No | — | Not currently supported |
Time in Force Options
| Option | API Value | Description |
|---|---|---|
| Good Till Canceled | GTC | Order remains until filled or canceled (default) |
| Immediate or Cancel | IOC | Fill immediately or cancel unfilled portion |
| Fill or Kill | FOK | Fill entire order immediately or cancel completely |
| Post Only | PostOnly | Only maker orders (adds liquidity, no taker fees) |
Understanding Bybit's Unified Trading Account
Bybit uses a Unified Trading Account (UTA), which is different from many other exchanges that have separate wallets.
What is UTA?
| Feature | Description |
|---|---|
| Single Wallet | One account for Spot, Derivatives, and Options |
| Shared Funds | No transfers needed between product types |
| Unified Margin | Cross-collateral across products |
Benefits for SignalBee Users
| Traditional Exchange | Bybit with UTA |
|---|---|
| Deposit to Spot wallet | Deposit once to UTA |
| Transfer to Futures wallet | ✅ Not needed |
| Transfer back to Spot | ✅ Not needed |
| Multiple balance displays | Single unified balance |
Key Point: With UTA, you don't need to transfer funds between Spot and Futures. Your deposited USDT is immediately available for all trading products.
Creating Your API Key
Follow these steps to create an API key with Futures permissions.
Step 1: Log In to Bybit
- Go to www.bybit.com
- Log in with your email/phone and password
- Complete 2FA verification (authenticator app)
Step 2: Navigate to API Management
- Click your profile icon in the top-right corner
- Select API from the dropdown menu
- You'll see a list of your existing API keys (if any)
Step 3: Create a New API Key
- Click the Create New Key button
- Select System-generated API Keys (recommended for trading)
- You may need to complete 2FA verification
Step 4: Configure Your API Key
- API Name - Enter a descriptive label:
SignalBee Futures - Key Type - Select the appropriate type for your account
Tip: Use a specific name like "SignalBee-Futures" so you can easily identify this key's purpose later.
Step 5: Set Permissions
Configure the permissions for your API key:
- ✅ Enable Read - View account info and positions
- ✅ Enable Contract - Orders - Place futures orders
- ✅ Enable Contract - Positions - Manage positions
- ❌ Do NOT enable Withdraw - Never needed
- ❌ Do NOT enable Transfer - Not required
Critical: You must enable Contract permissions (not just Spot). These are separate permissions for futures trading.
Step 6: IP Whitelist (Optional)
- Leave empty for unrestricted access, OR
- Add specific IP addresses for enhanced security (see IP Whitelist Configuration)
Step 7: Complete Security Verification
- Authenticator Code - Enter the 6-digit 2FA code
- Email Verification - Click the link sent to your email (if required)
- Wait for verification to complete
Step 8: Save BOTH Values IMMEDIATELY
After verification, Bybit displays your API credentials. You MUST save both:
| Value | Can View Later? | Action Required |
|---|---|---|
| API Key | ✅ Yes | Copy and save |
| Secret Key | ❌ NO - Never shown again | Copy immediately! |
Warning: The Secret Key is displayed only once. If you close the page without copying it, you'll need to delete this API key and create a new one.
Save both values in your password manager now before proceeding.
Note: Unlike Bitget, KuCoin, or OKX, Bybit does NOT require a passphrase. You only need the API Key and Secret Key.
Configuring Permissions
Configure the correct permissions to balance functionality and security.
Required Permissions
| Permission | Enable? | Why |
|---|---|---|
| Read | ✅ Yes | Allows SignalBee to check your balances and positions |
| Contract - Orders | ✅ Yes - REQUIRED | Allows SignalBee to place and manage futures orders |
| Contract - Positions | ✅ Yes - REQUIRED | Allows SignalBee to view and manage positions |
Never Enable These Permissions
| Permission | Enable? | Why |
|---|---|---|
| Withdraw | ❌ NEVER | SignalBee never needs withdrawal access. Enabling this is a serious security risk. |
| Transfer | ❌ No | Not required for SignalBee functionality |
| Spot Trade | Optional | Only if also using SignalBee for spot trading |
Critical: You MUST enable the Contract permissions. Without these, SignalBee cannot place futures orders even if your API key is valid. The Spot Trade permission is separate and won't work for futures.
How to Edit Permissions
- In API Management, find your SignalBee Futures API key
- Click the Edit button next to the key
- Modify the permission checkboxes as needed
- Click Confirm
- Complete 2FA verification
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?
| Scenario | Without Whitelist | With 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
- When creating or editing your API key, find the IP Addresses section
- Enter each SignalBee IP address (one per line)
- Click Confirm
- Complete verification
If You Skip IP Whitelisting
If you choose not to use IP whitelisting:
- Leave the IP address field empty
- Understand this is less secure but still safe if withdrawals are disabled
- Your other security measures (no withdrawal permission) still protect your funds
Adding to SignalBee
Now connect your Bybit Futures API key to SignalBee.
Step 1: Go to Exchanges Page
- Log in to your SignalBee account
- Navigate to Exchanges in the main menu
Step 2: Add New Exchange
- Click the Add Exchange button
- Select Bybit Perpetual from the exchange list
Critical: Make sure you select Bybit Perpetual, NOT "Bybit". These are different exchange connections for different account types. Selecting the wrong one will cause connection failures.
Step 3: Enter Your Credentials
Bybit Perpetual requires two fields only:
| Field | Value |
|---|---|
| API Key | Your Bybit API key |
| Secret Key | Your Bybit Secret key |
Note: There is NO passphrase field for Bybit. Unlike Bitget, KuCoin, or OKX, Bybit only requires two credentials.
Step 4: Test the Connection
- Click Save and Test Connection
- Wait for SignalBee to verify your credentials
- Look for the success message
Step 5: Verify Your Setup
After successful connection:
- Your Bybit balances should appear in SignalBee
- Check that your USDT balance is displayed correctly
- If balances show $0, verify your API permissions
Tip: If balances don't appear or show $0, verify that:
- You selected "Bybit Perpetual" (not "Bybit")
- Your API key has the Contract permissions enabled
- You have USDT in your Bybit account
Bybit Futures-Specific Considerations
Ticker Format
Bybit Futures uses the same ticker format as Bybit Spot - no special suffix needed:
| SignalBee Format | Bybit Format |
|---|---|
| BTC-USDT | BTCUSDT |
| ETH-USDT | ETHUSDT |
| SOL-USDT | SOLUSDT |
SignalBee automatically converts between formats. When configuring webhooks, use standard formats like BTC-USDT and SignalBee will handle the conversion.
Note: Unlike Bitget which uses
_UMCBLsuffix, Bybit Linear perpetuals use the same format as spot (e.g.,BTCUSDTfor both).
Contract Types
| Type | API Category | Symbol Format | SignalBee Support |
|---|---|---|---|
| USDT Linear | linear | BTCUSDT | ✅ Primary support |
| USDC Perpetual | linear | BTC-PERP | ❌ Not implemented |
| Inverse Perpetual | inverse | BTCUSD | ❌ Not implemented |
SignalBee supports USDT-margined Linear perpetual contracts.
Minimum Order Sizes
Bybit Futures enforces minimum order values:
| Category | Typical Minimum |
|---|---|
| Major pairs (BTC, ETH) | ~$5 USD equivalent |
| Altcoin pairs | ~$5-10 USD equivalent |
Tip: Check Bybit's trading rules for current minimums.
Trading Fees
| Fee Type | Standard Rate |
|---|---|
| Maker | 0.01% |
| Taker | 0.06% |
Note: Bybit has highly competitive maker fees at 0.01%. VIP tiers offer additional discounts.
API Rate Limits
- Trade requests: 10 requests per second
- Account/position requests: 10 requests per second
- SignalBee handles rate limiting automatically
- If you see rate limit errors, reduce your signal frequency
Testnet for Practice
Bybit provides a testnet environment for practice:
- Testnet URL: api-testnet.bybit.com
- Create separate testnet API keys at testnet.bybit.com
- Practice trading without risking real funds
- Test your signal configurations before going live
Position Mode Configuration
Bybit Futures supports two position modes. Choose based on your trading strategy.
One-way Mode (Default)
| Aspect | Description |
|---|---|
| API Value | mode: 0 |
| Behavior | Single net position per symbol |
| Long + Short | Not simultaneous (close long to open short) |
| Best For | Simple directional trading |
Hedge Mode
| Aspect | Description |
|---|---|
| API Value | mode: 3 |
| Behavior | Separate long and short positions |
| Long + Short | Can hold both simultaneously |
| Best For | Advanced strategies, hedging |
How to Change Position Mode
- Go to Bybit Derivatives trading page
- Click the Settings icon (gear)
- Select Position Mode
- Choose One-Way Mode or Hedge Mode
- Confirm the change
Important: You cannot change position mode while you have open positions or pending orders. Close all positions and cancel all orders first.
Leverage and Margin Configuration
Setting Leverage
Leverage is configured per trading pair on Bybit:
- Open the trading page for your desired pair (e.g., BTCUSDT)
- Click the leverage display (e.g., "10x")
- Use the slider to select your desired leverage (1x to 100x)
- Click Confirm
| Symbol Category | Typical Max Leverage |
|---|---|
| BTC, ETH | Up to 100x |
| Major Altcoins | Up to 75x |
| Smaller Altcoins | Up to 50x |
Recommendation: Start with 5x leverage or less until you're comfortable with futures trading. Higher leverage means faster liquidation.
Margin Types
| Type | API Value | Description | Best For |
|---|---|---|---|
| Cross | tradeMode: 0 | Entire account balance as margin | Avoiding liquidation, larger accounts |
| Isolated | tradeMode: 1 | Only allocated margin at risk | Limiting losses per trade |
How to Switch Margin Type
- On the trading page, find the margin mode indicator
- Click to switch between Cross and Isolated
- For Isolated, you can set the margin amount per position
Tip: Isolated margin limits your maximum loss to the margin allocated to that position. Cross margin uses your entire Futures balance.
Understanding Liquidation
When your position losses exceed your margin:
- Your position is automatically closed (liquidated)
- You lose the margin allocated to that position
- With cross margin, liquidation uses more of your account balance
Liquidation price is shown on each open position. Always know your liquidation price before entering a trade.
Troubleshooting
Common Bybit Futures-specific errors and solutions:
| Error | Code | Likely Cause | Solution |
|---|---|---|---|
| Invalid API Key | 10003-10005 | Typo or deleted key | Re-copy API key carefully. Check key exists in Bybit. |
| Invalid Signature | 10004 | Incorrect Secret Key | Re-copy Secret Key. If lost, delete key and create new one. |
| Timestamp Error | 10002 | Clock sync issue | Usually temporary. SignalBee handles automatic retry and time sync. |
| Permission Denied | — | Missing Contract permissions | Enable Contract - Orders and Contract - Positions in API settings. |
| Insufficient Margin | 110007 | Not enough funds | Add USDT to your Bybit account. |
| Invalid Symbol | 110130 | Wrong symbol format | Verify symbol exists on Bybit Futures. Use format like BTCUSDT. |
| Order Not Found | 110043, 110001 | Order already filled or canceled | Order may have been processed already. Check order history. |
| Hedge Mode Not Supported | 110025 | Symbol doesn't support hedge mode | Use one-way mode for this symbol. |
| Quantity Too Small | 110018 | Order quantity below minimum | Increase order quantity to meet Bybit minimums. |
| Min Notional Error | 170124 | Order value too small | Increase order size (quantity × price) to meet minimum. |
| Price Too Low | 110014 | Limit price too far from market | Increase limit price closer to current market. |
| Price Too High | 110015 | Limit price too far from market | Reduce limit price closer to current market. |
| Invalid Leverage | 110020 | Invalid leverage for symbol | Check maximum leverage allowed for this symbol. |
| Position Mode Change Failed | 110021 | Open positions exist | Close all positions and cancel all orders first. |
| Rate Limit | 10006 | Too many requests | Reduce signal frequency. SignalBee handles retries automatically. |
Connection Test Fails?
If your connection test fails in SignalBee:
- Verify exchange selection - Must be "Bybit Perpetual", not "Bybit"
- Check both values - API Key and Secret Key must both be correct
- Verify Contract permissions - Must have Contract - Orders AND Contract - Positions enabled
- Wait a few minutes - New API keys may take 1-2 minutes to activate
- Check IP whitelist - If configured, ensure SignalBee's IPs are included
Funds Show as $0?
If SignalBee shows $0 balance:
- Verify exchange type - "Bybit Perpetual" connects to your derivatives account
- Check USDT balance - Ensure you have USDT deposited in Bybit
- Check Reading permission - API key needs Read permission enabled
For persistent issues, see our Error Codes Reference or contact support@signalbee.trade.
Risk Warnings
CRITICAL: Perpetual futures trading carries significant risk. Read this section carefully.
Leverage Amplifies Both Gains AND Losses
| Leverage | 10% Price Move Against You |
|---|---|
| 1x | 10% loss |
| 5x | 50% loss |
| 10x | 100% loss (liquidated) |
| 20x | Liquidated at 5% move |
Higher leverage = faster liquidation. A 1% adverse price movement with 100x leverage results in complete loss.
Liquidation is Automatic and Final
- When margin is depleted, your position is forcibly closed
- You lose the entire margin allocated to that position
- There is no way to recover from liquidation
- Liquidation fees apply on top of losses
Funding Rates Affect Position Costs
- Perpetual contracts have funding payments every 8 hours
- If you're long and funding is positive, you pay shorts
- If you're short and funding is positive, you receive payment
- Funding can significantly affect profitability of longer-term positions
Risk Management Best Practices
- Start with low leverage (5x or less) until experienced
- Always use stop-losses to limit potential losses
- Never trade with funds you can't afford to lose
- Size positions appropriately - don't risk entire account
- Understand your liquidation price before entering trades
- Monitor funding rates for held positions
- Practice on testnet first before trading real funds
- Consider isolated margin to limit maximum loss per trade
Not Suitable For
Futures trading may not be appropriate if you:
- Are new to cryptocurrency trading
- Cannot afford to lose your entire investment
- Don't understand leverage and liquidation mechanics
- Are unable to monitor positions regularly
- Have high risk aversion
Security Best Practices
Follow this checklist to keep your Bybit account secure:
Bybit Account Security
- Enable 2FA with an authenticator app (Google Authenticator, Authy) - more secure than SMS
- Use a unique, strong login password for Bybit (not reused from other sites)
- Enable withdrawal address whitelist - restricts withdrawals to pre-approved addresses
API Key Security
- Create a dedicated API key just for SignalBee Futures - don't reuse keys
- 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 both credentials in a password manager (1Password, Bitwarden, etc.)
- Use separate API keys for Spot and Futures if using both
Ongoing Security
- Review your API keys periodically in Bybit - delete any you don't recognize
- Rotate API keys every 90 days as a security habit
- Monitor trade and position history for any unauthorized activity
- Keep your email secure - it's used for Bybit account recovery
Security Note: Even with all 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.
Related Resources
- Bybit Spot Setup - For spot trading on Bybit
- API Key Best Practices - General API key security guidance
- Security Overview - How SignalBee protects your data
- Error Codes Reference - Common error messages explained