Exchange Connectors
Exchange Types¶
Hummingbot connectors standardize trading logic and order types across different exchange types. All code related to each connector is housed in a folder located in the Hummingbot codebase.
We classify connectors using the following labels:
- SPOT: An exchange that trades spot markets
- PERP: An exchange that trades perpetual swap markets
- CEX: A centralized exchange that takes custody of user assets
- DEX: A decentralized exchange in which user assets are stored non-custodially in smart contracts
- CLOB: An exchange that uses a Central Limit Order Book to match makers and takers
- AMM: A DEX that uses Automatic Market Maker (AMM) smart contracts, popularized by Uniswap-V2
- AMM-RANGE: A DEX that uses Automatic Market Maker (AMM) smart contracts that let liquidity providers specify a range, popularized by Uniswap-V3
Connector Tiers¶
Quarterly Polls allow the Hummingbot community to vote using HBOT tokens to rank the exchanges in the codebase. This decides which connectors should be included going forward, and how they are maintained:
Gold¶
The two Gold exchanges are the top CEX and DEX selected by HBOT voters in the latest Poll. Their connectors are maintained by Hummingbot Foundation and are continually improved, serving as the "gold standard" template for all other connectors of that type.
| Exchange | Type | Signup code |
|---|---|---|
| Binance | SPOT CLOB CEX | FQQNNGCD |
| Binance (perp) | PERP CLOB CEX | hummingbot |
| Uniswap | SPOT AMM-RANGE DEX |
Silver¶
Silver exchanges are prioritized by HBOT holders in the latest Poll. Their connectors are maintained by Hummingbot Foundation via community developer bounties, tracking improvements made to the Gold connectors.
| Exchange | Type | Signup code |
|---|---|---|
| Kucoin | SPOT CLOB CEX | 272KvRf |
| Kucoin (perp) | PERP CLOB CEX | 272KvRf |
| Gate.io | SPOT CLOB CEX | 5868285 |
| Gate.io (perp) | PERP CLOB CEX | 5868285 |
| AscendEx | SPOT CLOB CEX | UEIXNXKW |
| Pancakeswap | SPOT AMM DEX | |
| Sushiswap | SPOT AMM DEX | |
| dYdX | PERP CLOB DEX |
Bronze¶
Bronze exchange connectors have passed the Minimum Voting Power Threshold in the latest Poll and are included in each monthly release. They are not maintained by Hummingbot Foundation but may be maintained by a community member.
Connector Maintenance¶
Exchange connectors may have a maintainer who is responsible for ongoing maintenance: fixing bugs, addressing user issues, and keeping up with exchange API and Hummingbot connector standard updates. Specifically, maintainer responsibilities include:
- Addressing user Github issues and pull requests related to the connector
- Keeping the connector updated for changes to the exchange API and Hummingbot connector standard for that exchange type
- Keeping the connector's documentation page updated
Hummingbot Foundation is the maintainer for the GOLD and SILVER exchange connectors.
Our sister company CoinAlpha maintains the following BRONZE connectors:
| Exchange | Type | Signup code |
|---|---|---|
| Bitget | PERP CLOB CEX | |
| Bitmart | SPOT CLOB CEX | UM6fQV |
| CI-EX | SPOT CLOB CEX | |
| Dexalot | SPOT CLOB DEX | |
| NDAX | SPOT CLOB CEX | |
| LBank | SPOT CLOB CEX | |
| Mad Meerkat | SPOT AMM DEX | |
| Pangolin | SPOT AMM DEX | |
| Ref | SPOT AMM DEX | |
| Trader Joe | SPOT AMM DEX | |
| VVS | SPOT AMM DEX | |
| XSSwap | SPOT AMM DEX |
Contributing Connectors¶
Developers may submit connectors as pull requests. See Contribution Guidelines for the process to get pull requests merged into the codebase.