What are exchange connectors?¶
Exchange connectors are packages of code that link Hummingbot's internal trading algorithms with live information from different cryptocurrency exchanges. They interact with a given exchange's API, such as by gathering order book data and sending and cancelling trades.
You can find the existing connectors here. Note that each folder contained here marks different exchange connector types. These should serve as a template for creating a new exchange connector.
Building a new exchange connector requires conforming to the template code to the new exchange's APIs, identifying and handling any differences in functions/behaviors, and testing the new exchange connector on that exchange.
The Gold Standard
Exchange connector requirements¶
Introducing an exchange connector into the Hummingbot code base requires a mutual commitment from the Hummingbot team and community developers to maintaining a high standard of code quality and software reliability.
We encourage and welcome contributions from the community, subject to the guidelines and expectations outlined below.
- Connector folder: A folder that contains a complete set of connector files based off of the examples above.
- Unit tests: Tests that cover at least 80% of the new code — see the tests in the connectors above.
- Inline code comments (particularly for any code that is materially different from the templates)
- Documentation: Documentation that contains useful information about the exchange for bot users
Submit a pull request with the connector to the
developmentbranch in Github, following the Contribution Guidelines.
Submit a Pull Request Proposal (PRP) in the Hummingbot PRP Snapshot. In particular, the PRP should identify a dedicated maintainer who will be responsible for fixing bugs and applying updates.