Skip to main content
Gateway is DEX middleware that enables Hummingbot API to trade on decentralized exchanges. It provides a standardized interface to swap tokens, provide liquidity, and interact with DeFi protocols across multiple blockchains.

What is Gateway?

Gateway is a separate service that:
  • Connects to blockchain RPCs (Ethereum, Solana, etc.)
  • Manages wallet keys and transaction signing
  • Provides unified API for different DEX protocols
  • Handles gas estimation and transaction submission

Supported Protocols

AMM Swaps

CLMM (Concentrated Liquidity)

Supported Chains

How Hummingbot API Uses Gateway

Swaps

Execute token swaps via the /gateway/swap endpoints:
Past swaps are searchable via POST /gateway/swaps/search, and a transaction’s status via GET /gateway/swaps/{transaction_hash}/status.

Liquidity Provision

Manage CLMM positions via /gateway/clmm endpoints:
Full-range AMM liquidity has its own parallel router under /gateway/amm (pool-info, quote-liquidity, add/remove-liquidity).

Setup

1. Configure Gateway

Gateway’s per-network configuration (RPC endpoints, tokens, pools) is readable and writable through the API:
Updating a network’s config is a POST to the same path; tokens and pools have their own subpaths (/gateway/networks/{network_id}/tokens, /gateway/networks/{network_id}/pools).

2. Add Wallets

Add wallet credentials via Condor or API: Telegram:
API:

3. Verify Connection

Check Gateway status:

Gateway vs CEX Connectors

Resources

Gateway GitHub

Gateway source code

Gateway Docs

Full Gateway documentation