DEX / Blockchain Experience Needed
Since running DEX trading bots successfully is more complex and entails more specialized blockchain engineering than running CEX bots, we recommend Gateway for users with prior blockchain engineering or DEX trading experience.
What is Gateway?¶
Hummingbot Gateway is open source API middleware that helps the Hummingbot client to connect to decentralized exchanges (DEX) on various blockchain networks.
Gateway manages interfacing with DEX connectors and exposes standard REST API endpoints for trading and liquidity-related functionality on these DEXs.
Essentially, Gateway is a light web server that enables Hummingbot to send and receive data from different blockchain protocols and provides an easier entry point for external devs to build connectors to other protocols.
See DEX Connectors for the DEXs that Gateway currently supports, which are listed in the Connection column.
See Chains for a list of blockchains and their networks that Gateway currently supports.
hummingbot/connector/gateway folder contains the sub-standards that are currently supported:
How to use Gateway¶
Following the guides below to install, configure and use Gateway:
- Installation: How to install Gateway from source or via Docker
- Testing with Postman: How to test Gateway API endpoints on a standalone basis using Postman and other tools
- Using Gateway with Hummingbot : How to send commands to Gateway from Hummingbot
- Working with Tokens: Adding tokens, approving tokens and getting testnet tokens
- Running DEX Bots: How to run the
amm-arbstrategy and scripts that use Gateway DEX connectors
- Adding Connectors: Developer guide for contributing new DEX connectors into the open source Gateway codebase
Gateway included a Swagger-based API documentation server that is provided at http://localhost:8080 when Gateway is started. The documentation provides a list of the Gateway API endpoints and examples on how to use them.
See the following blog posts from CoinAlpha CTO Martin Kou for more information about Gateway's history, background, and intended developer experience: