Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/hummingbot/hummingbot/llms.txt

Use this file to discover all available pages before exploring further.

CLOB CEX Spot connectors enable trading on centralized exchanges with central limit order books for spot markets. These exchanges take custody of your funds and provide high liquidity, fast execution, and advanced trading features.

How CLOB CEX Spot Connectors Work

Centralized spot exchange connectors integrate with exchange APIs to provide:

Order Management

Place, cancel, and modify limit and market orders through standardized interfaces

Real-time Data

WebSocket connections for live order book updates, trades, and account balances

Account Operations

Query balances, trading fees, and account information across exchanges

API Authentication

Secure API key management with encrypted local storage

Connection Requirements

1

Generate API keys

Create API keys from your exchange account with these permissions:
  • Read account balances
  • Place orders
  • Cancel orders
Never enable withdrawal permissions on API keys used for trading bots.
2

Configure in Hummingbot

Use the connect command:
connect [exchange_name]
Enter your API key and secret when prompted.
3

Verify connection

Check your balance to confirm:
balance

Exchange Sponsors

These centralized spot exchanges actively support Hummingbot through partnerships and fee discounts:
Connector ID: binanceThe world’s largest cryptocurrency exchange by trading volume.Features:
  • Extensive trading pairs (600+ markets)
  • Deep liquidity and tight spreads
  • Low trading fees (0.1% maker/taker)
  • Advanced order types
Discount: 10% fee discount with Hummingbot referral linkExchange Documentation
Connector ID: bitmartGlobal cryptocurrency exchange with diverse trading pairs.Features:
  • Wide selection of altcoins
  • Competitive trading fees
  • Spot and margin trading
Discount: Sponsor partnership with referral linkExchange Documentation
Connector ID: bitgetLeading cryptocurrency exchange with copy trading features.Features:
  • Popular for derivatives and spot trading
  • Copy trading capabilities
  • Low latency API
Discount: Sponsor partnership with referral linkExchange Documentation
Connector ID: gate_ioEstablished exchange with extensive altcoin offerings.Features:
  • 1,700+ trading pairs
  • Advanced trading tools
  • Multiple order types
  • Startup project listings
Discount: 20% fee discount with Hummingbot referral linkExchange Documentation
Connector ID: htxMajor exchange with strong presence in Asian markets.Features:
  • Established since 2013
  • Wide range of trading pairs
  • Institutional-grade platform
Discount: 20% fee discount with Hummingbot referral linkExchange Documentation
Connector ID: kucoinPeople’s exchange with diverse cryptocurrency offerings.Features:
  • 700+ trading pairs
  • Early access to new tokens
  • Trading bot marketplace
  • Low trading fees
Discount: 20% fee discount with Hummingbot referral linkExchange Documentation
Connector ID: okxTop-tier exchange with comprehensive trading products.Features:
  • Advanced trading interface
  • Deep liquidity
  • Institutional services
  • Multiple trading modes
Discount: 20% fee discount with Hummingbot referral linkExchange Documentation

Other Supported Exchanges

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

AscendEx

Connector ID: ascend_exDeFi-focused exchange platformDocs

BingX

Connector ID: bing_xSocial trading exchangeDocs

Bitrue

Connector ID: bitrueXRP Ledger integrated exchangeDocs

Bitstamp

Connector ID: bitstampLongest-running crypto exchangeDocs

BTC Markets

Connector ID: btc_marketsAustralian cryptocurrency exchangeDocs

Bybit

Connector ID: bybitPopular derivatives exchangeDocs

Coinbase

Connector ID: coinbase_advanced_tradeLeading US cryptocurrency exchangeDocs

Cube

Connector ID: cubeInstitutional trading platformDocs

Kraken

Connector ID: krakenTrusted US-based exchangeDocs

MEXC

Connector ID: mexcHigh-performance trading platformDocs

Supported Features

CLOB CEX Spot connectors support the following trading features:
FeatureSupport
Limit ordersYes
Market ordersYes
Stop-loss ordersYes (exchange dependent)
Order book dataYes (WebSocket)
Trade dataYes (WebSocket)
Balance updatesYes
Fee structureMaker/taker fees
Rate limitingExchange-specific
Specific features may vary by exchange. Check individual exchange documentation for detailed feature support.

Configuration Example

Example configuration for a CLOB CEX spot connector:
connector: binance
market: BTC-USDT
order_amount: 0.001
order_refresh_time: 30

Best Practices

API Key Security
  • Use API keys with minimal required permissions
  • Never share API keys or commit them to version control
  • Rotate API keys periodically
  • Monitor API usage for unusual activity
Trading Performance
  • Choose exchanges with deep liquidity for your trading pairs
  • Consider maker/taker fee structures in your strategy
  • Monitor API rate limits to avoid connection issues
  • Test strategies with small amounts before scaling

Next Steps

CLOB CEX Perpetual

Explore perpetual futures connectors

Getting Started

Install Hummingbot and start trading

Strategies

Learn about trading strategies

Governance

Participate in connector governance