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 DEX Spot connectors enable trading on decentralized exchanges with on-chain central limit order books. These exchanges are non-custodial, meaning you maintain control of your private keys and funds at all times.

​
How CLOB DEX Spot Connectors Work

Decentralized limit order book exchanges combine the transparency of blockchain with traditional order book trading:

Non-Custodial

You control your private keys. Trades settle on-chain without surrendering custody

On-Chain Settlement

All trades are recorded on the blockchain, providing transparency and auditability

Wallet Integration

Connect using wallet private keys instead of API keys from centralized platforms

Gas Management

Transaction fees paid in native blockchain tokens for order placement and execution

​
Key Advantages

Maintain full control of your assets:
  • No exchange custody risk
  • No withdrawal delays or limits
  • Direct wallet-to-wallet trading
  • Trustless settlement

​
Connection Requirements

1

Set up a trading wallet

Create a dedicated wallet for trading:
  • Generate a new wallet address
  • Fund with tokens for trading
  • Add native tokens for gas fees
Always use a dedicated trading wallet. Never use your primary wallet with significant holdings for bot trading.
2

Configure RPC endpoint

Set up blockchain connectivity:
  • Public RPC (free but potentially slower)
  • Private RPC (paid but faster and more reliable)
  • Consider redundant endpoints
3

Connect in Hummingbot

Use your wallet private key:
connect [exchange_name]
Enter your private key when prompted (stored encrypted locally).

​
Exchange Sponsors

These decentralized spot exchanges actively support Hummingbot:
Connector ID: deriveHigh-performance CLOB DEX on Lyra chain.Features:
  • On-chain order book
  • Fast settlement (sub-second)
  • Low gas fees
  • Spot and derivatives support
  • Built on Lyra (Optimistic rollup)
Network: Lyra ChainExchange Documentation
Connector ID: hyperliquidFully on-chain order book DEX with spot trading.Features:
  • Native L1 blockchain
  • High-performance matching engine
  • Spot and perpetual markets
  • Zero gas fees for makers
  • Sub-second finality
Network: Hyperliquid L1Exchange Documentation
Connector ID: xrplNative decentralized exchange on XRP Ledger.Features:
  • Built-in DEX functionality
  • Pathfinding for multi-hop trades
  • Auto-bridging via XRP
  • Low transaction costs
  • 3-5 second settlement
Network: XRP LedgerExchange Documentation

​
Other Supported Exchanges

The following CLOB DEX spot exchanges are maintained through governance:

Dexalot

Connector ID: dexalotOrder book DEX on Avalanche subnet.Features:
  • Dedicated Avalanche subnet
  • Gas-free trading
  • Familiar order book interface
  • Bridge from C-Chain
Network: Dexalot Subnet (Avalanche)Exchange Documentation

Injective Helix

Connector ID: injective_v2Fully decentralized order book exchange.Features:
  • Layer-1 blockchain
  • Lightning-fast trades
  • Zero gas fees
  • Cross-chain bridges
  • MEV resistant
Network: InjectiveExchange Documentation

Vertex

Connector ID: vertexHybrid CLOB DEX on Arbitrum.Features:
  • Order book and AMM
  • Integrated money markets
  • Cross-margined positions
  • Fast execution
Network: Arbitrum OneExchange Documentation

​
Supported Features

CLOB DEX Spot connectors support order book trading features:
FeatureSupport
Limit ordersYes
Market ordersYes
Post-only ordersYes (exchange dependent)
Order cancellationYes
Order book dataYes
On-chain settlementYes
Gas estimationYes
Nonce managementAutomatic
Transaction retryYes
Gas fees vary by blockchain network and congestion. Always maintain sufficient native tokens for gas.

​
Gas Fee Considerations

Unlike centralized exchanges, CLOB DEXs require gas fees:
Gas Fee Structure
  • Order placement: Gas fee to submit order on-chain
  • Order cancellation: Gas fee to cancel (some exchanges)
  • Trade execution: Gas fee paid by taker
  • Batch operations: Some DEXs support batching to reduce fees
Optimizing Gas Costs
  1. Choose Layer 2 or app-specific chains with lower fees
  2. Batch operations when possible
  3. Use longer-lived orders to reduce placement frequency
  4. Monitor gas prices and trade during low-congestion periods
  5. Consider maker-only strategies on exchanges with maker rebates

​
Wallet Security

Private Key SafetyCLOB DEX connectors require your wallet private key:
  • Keys are encrypted and stored locally only
  • Never shared with external servers
  • Use a dedicated trading wallet with limited funds
  • Regularly rotate wallets and test recovery procedures
  • Consider hardware wallet integration where supported

​
Blockchain Connectivity

Reliable RPC connectivity is critical:
Free RPC endpoints:
  • Lower cost (free)
  • Rate limited
  • Potentially slower
  • Less reliable during high load
Best for: Testing and low-frequency strategies

​
Configuration Example

Example configuration for a CLOB DEX spot connector: 
connector: hyperliquid
market: ETH-USDC
order_amount: 0.1
order_refresh_time: 60
gas_price_multiplier: 1.2  # Adjust for faster confirmation

​
Network Requirements

Each CLOB DEX operates on specific blockchain networks:
ExchangeNetworkNative TokenAvg Gas Cost
DeriveLyra ChainETH~$0.01
HyperliquidHyperliquid L1HYPE$0 (makers)
XRP LedgerXRP LedgerXRP~$0.0001
DexalotDexalot SubnetALOT$0
InjectiveInjectiveINJ$0
VertexArbitrum OneETH~$0.10

​
Next Steps

CLOB DEX Perpetual

Explore decentralized perpetual connectors

CLOB CEX Spot

Compare with centralized exchanges

Wallet Setup

Configure wallets for DEX trading

Getting Started

Install Hummingbot