Skip to main content
CLOB CEX Perpetual connectors enable trading perpetual futures contracts on centralized exchanges. These connectors provide access to leveraged trading with funding rates, liquidation mechanisms, and advanced risk management features.

​
How CLOB CEX Perpetual Connectors Work

Perpetual futures connectors extend spot trading capabilities with derivatives-specific features:

Leverage Trading

Trade with leverage up to 100x on supported exchanges with margin management

Funding Rates

Automatic handling of perpetual funding rate payments between long and short positions

Position Management

Track and manage open positions, unrealized PnL, and liquidation prices

Risk Controls

Built-in safeguards for margin requirements and liquidation protection

​
Key Differences from Spot

Perpetual connectors support leveraged trading:
  • Trade with borrowed capital (up to 100x leverage)
  • Increased profit potential and risk
  • Margin requirements and maintenance
  • Automatic deleveraging in extreme conditions

​
Connection Requirements

1

Generate API keys

Create API keys with futures trading permissions:
  • Read account balances
  • Place and cancel orders
  • Access futures positions
  • Read funding rate data
Never enable withdrawal permissions. Use separate API keys for futures and spot trading.
2

Configure in Hummingbot

Connect using the perpetual connector ID:
connect [exchange_name]_perpetual
3

Set leverage

Configure your desired leverage level:
# Most exchanges default to cross margin mode
# Leverage can be adjusted per trading pair

​
Exchange Sponsors

These centralized perpetual exchanges actively support Hummingbot:
Connector ID: binance_perpetualWorld’s largest perpetual futures exchange by volume.Features:
  • 200+ perpetual contracts
  • Up to 125x leverage
  • Cross and isolated margin modes
  • Deep liquidity and tight spreads
  • USDⓈ-M and COIN-M futures
Discount: 10% fee discount with Hummingbot referral linkExchange Documentation
Connector ID: bitmart_perpetualGrowing perpetual futures platform.Features:
  • Multiple perpetual contracts
  • Competitive leverage options
  • User-friendly interface
  • Cross margin support
Discount: Sponsor partnership with referral linkExchange Documentation
Connector ID: bitget_perpetualLeading derivatives exchange with copy trading.Features:
  • Popular perpetual contracts
  • Up to 125x leverage
  • Copy trading for futures
  • Advanced risk management
Discount: Sponsor partnership with referral linkExchange Documentation
Connector ID: gate_io_perpetualComprehensive derivatives trading platform.Features:
  • 300+ perpetual contracts
  • Up to 100x leverage
  • Multiple margin modes
  • Portfolio margin option
Discount: 20% fee discount with Hummingbot referral linkExchange Documentation
Connector ID: kucoin_perpetualDerivatives platform with diverse contracts.Features:
  • Wide range of perpetual contracts
  • Up to 100x leverage
  • Cross and isolated margin
  • Low trading fees
Discount: 20% fee discount with Hummingbot referral linkExchange Documentation
Connector ID: okx_perpetualAdvanced derivatives trading platform.Features:
  • Extensive perpetual offerings
  • Up to 125x leverage
  • Portfolio margin mode
  • Unified trading account
  • Options and futures
Discount: 20% fee discount with Hummingbot referral linkExchange Documentation

​
Other Supported Exchanges

The following perpetual exchanges are maintained through the Hummingbot Foundation governance process:

Bybit Perpetual

Connector ID: bybit_perpetualMajor derivatives exchange with retail and institutional offerings.Features:
  • USDT and USDC perpetuals
  • Up to 100x leverage
  • Unified margin account
  • Derivatives-focused platform
Exchange Documentation

​
Supported Features

CLOB CEX Perpetual connectors support advanced derivatives features:
FeatureSupport
Limit ordersYes
Market ordersYes
Stop-loss ordersYes
Take-profit ordersYes
Leverage adjustmentYes
Cross marginYes
Isolated marginYes (exchange dependent)
Position trackingYes
Funding rate dataYes
Liquidation priceYes
Reduce-only ordersYes
Leverage limits and margin modes vary by exchange. Always check exchange-specific documentation.

​
Trading Perpetuals Safely

Liquidation RiskPerpetual futures carry significant liquidation risk:
  • Leverage amplifies both gains and losses
  • Positions can be liquidated if margin falls below maintenance level
  • Market volatility can trigger rapid liquidations
  • Always use stop-loss orders and position sizing
Risk Management Best Practices
  1. Start with low leverage (2-5x) until familiar with the exchange
  2. Use isolated margin for better risk control per position
  3. Monitor funding rates - they impact profitability on long positions
  4. Set stop-loss orders to limit downside
  5. Size positions appropriately - never risk more than 1-2% per trade
  6. Test with small amounts before deploying significant capital

​
Funding Rate Considerations

Funding rates affect strategy profitability: 
# Funding typically occurs every 8 hours
position_size = 10000  # USDT
funding_rate = 0.01  # 1% (annualized ~10%)

# Cost per funding period
funding_cost = position_size * funding_rate
print(f"Funding cost: ${funding_cost}")  # $100

# Daily cost (3 funding periods)
daily_cost = funding_cost * 3
print(f"Daily cost: ${daily_cost}")  # $300
Positive funding rates mean longs pay shorts. During strong bull markets, funding can be significantly positive, making short-term long positions expensive.

​
Configuration Example

Example configuration for a perpetual connector: 
connector: binance_perpetual
market: BTC-USDT
leverage: 10
order_amount: 0.01
order_refresh_time: 30
margin_mode: cross  # or isolated

​
Next Steps

CLOB CEX Spot

Learn about spot trading connectors

Risk Management

Advanced risk management strategies

CLOB DEX Perpetual

Explore decentralized perpetual connectors

Getting Started

Install Hummingbot

Build docs developers (and LLMs) love

Get started for freeTalk to us