Gateway DEX Connectors¶
Gateway provides standardized connectors for interacting with decentralized exchanges (DEXs) across different blockchain networks. Each connector implements one or more trading types (Router, AMM, CLMM) to support various DeFi protocols.
Supported Connectors¶
Note
The Gateway refactoring approved in NCP-22 has been completed with the v2.8.0 release. The new standard is now ready, and developers can help upgrade the legacy connectors to the new architecture. Community developers can claim bounties for these upgrades where available.
Active Connectors¶
| Protocol | Chain | Router | AMM | CLMM | Description |
|---|---|---|---|---|---|
| Jupiter | Solana | ✅ | ❌ | ❌ | Leading DEX aggregator on Solana |
| Meteora | Solana | ❌ | ❌ | ✅ | Dynamic Liquidity Market Maker (DLMM) |
| Raydium | Solana | ❌ | ✅ | ✅ | Full-featured DEX with AMM and CLMM |
| Uniswap | Ethereum/EVM | ✅ | ✅ | ✅ | The original AMM DEX with V2, V3, and Universal Router |
Legacy Connectors¶
The following connectors are available in legacy versions but need to be upgraded to the v2.8.0 standard:
| Protocol | Chain | Router | AMM | CLMM | Bounty |
|---|---|---|---|---|---|
| PancakeSwap | BNB Chain | ✅ | ✅ | ✅ | #7654 |
| Balancer | Ethereum/EVM | ❌ | ✅ | ❌ | #7653 |
| Curve | Ethereum/EVM | ❌ | ✅ | ❌ | #7652 |
| SushiSwap | Ethereum/EVM | ✅ | ✅ | ✅ | - |
| QuickSwap | Polygon | ❌ | ✅ | ✅ | - |
| TraderJoe | Avalanche | ❌ | ✅ | ✅ | - |
| ETCSwap | Ethereum Classic | ❌ | ✅ | ✅ | - |
Connector Schemas¶
Gateway implements three standardized schemas that define the API structure for different trading types. Each connector must implement one or more of these schemas to ensure compatibility with Hummingbot.
Router Schema¶
For DEX aggregators and swap-only protocols. Focuses on quoting optimal trade routes across multiple liquidity sources and executing quotes.
Key Endpoints:
quote-swap: Get optimal swap quote with routing detailsexecute-swap: Execute swap directlyexecute-quote: Execute pre-fetched quote
AMM Schema¶
For traditional Automated Market Maker pools with constant product (x*y=k) formulas, such as Uniswap V2 and Raydium Standard Pools.
Key Endpoints:
pool-info: Get pool reserves and pricingposition-info: Get current liquidity position detailsquote-liquidity: Calculate liquidity provision amountsadd-liquidity: Add liquidity to poolremove-liquidity: Remove liquidity from pool
CLMM Schema¶
For Concentrated Liquidity Market Maker pools where liquidity providers can specify custom price ranges such as Uniswap V3 and Raydium Concentrated Pools.
Key Endpoints:
positions-owned: List all positions for an addressquote-position: Calculate position parameters for price rangeopen-position: Create new concentrated liquidity positionadd-liquidity: Add liquidity to existing positionremove-liquidity: Remove liquidity from positioncollect-fees: Collect earned feesclose-position: Close position and withdraw all liquidity
Building Custom Connectors¶
For detailed instructions on building custom Gateway DEX connectors, see Building Gateway Connectors.