Exchanges
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 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, while community members may maintain other connectors. For instance, CoinAlpha maintains a number of Bronze connectors in the codebase. Individual developers and exchanges may register with us to be assigned the maintainer role for other Bronze connectors.
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 | Maintainer | Signup code |
|---|---|---|---|
| Binance | SPOT CLOB CEX | Hummingbot Foundation | FQQNNGCD |
| Binance (perp) | PERP CLOB CEX | Hummingbot Foundation | hummingbot |
| Uniswap | SPOT AMM-RANGE DEX | Hummingbot Foundation |
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 | Maintainer | Signup code |
|---|---|---|---|
| Kucoin | SPOT CLOB CEX | Hummingbot Foundation | 272KvRf |
| Kucoin (perp) | PERP CLOB CEX | Hummingbot Foundation | 272KvRf |
| Gate.io | SPOT CLOB CEX | Hummingbot Foundation | 5868285 |
| Gate.io (perp) | PERP CLOB CEX | Hummingbot Foundation | 5868285 |
| AscendEx | SPOT CLOB CEX | Hummingbot Foundation | UEIXNXKW |
| Quickswap | SPOT AMM DEX | Hummingbot Foundation | |
| TraderJoe | SPOT AMM DEX | Hummingbot Foundation | CoinAlpha |
| dYdX | PERP CLOB DEX | Hummingbot Foundation |
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.
| Exchange | Type | Maintainer | Signup code |
|---|---|---|---|
| AltMarkets | SPOT CLOB CEX | ||
| BTC-Markets | SPOT CLOB CEX | ||
| Binance US | SPOT CLOB CEX | ||
| BitGet | PERP CLOB CEX | CoinAlpha | |
| Bit.com | PERP CLOB CEX | ||
| Bitmart | SPOT CLOB CEX | CoinAlpha | UM6fQV |
| Bitfinex | SPOT CLOB CEX | ||
| Bitmex | SPOT CLOB CEX | ||
| Bitmex (perp) | PERP CLOB CEX | ||
| Bittrex | SPOT CLOB CEX | ||
| Bybit | SPOT CLOB CEX | ||
| Bybit (perp) | PERP CLOB CEX | ||
| Coinbase | SPOT CLOB CEX | ||
| Crypto.com | SPOT CLOB CEX | ||
| DeFi Kingdoms | SPOT AMM DEX | ||
| Defira | SPOT AMM DEX | ||
| Dexalot | SPOT CLOB DEX | CoinAlpha | |
| Foxbit | SPOT CLOB CEX | ||
| HitBTC | SPOT CLOB CEX | ||
| Hotbit | SPOT CLOB CEX | ||
| Huobi | SPOT CLOB CEX | en9k2223 | |
| Injective | SPOT CLOB DEX | ||
| Injective (perp) | PERP CLOB DEX | ||
| Kraken | SPOT CLOB CEX | ||
| LBank | SPOT CLOB DEX | ||
| Loopring | SPOT CLOB DEX | ||
| MEXC | SPOT CLOB CEX | ||
| Mad Meerkat | SPOT AMM DEX | CoinAlpha | |
| NDAX | SPOT CLOB DEX | CoinAlpha | |
| OKX | SPOT CLOB CEX | 1931920 | |
| OpenOcean | SPOT AMM DEX | ||
| Pancakeswap | SPOT AMM DEX | ||
| Pangolin | SPOT AMM DEX | CoinAlpha | |
| Perpetual Protocol | PERP AMM DEX | ||
| Phemex Perpetual | PERP CLOB CEX | CoinAlpha | |
| ProBit | SPOT CLOB CEX | ||
| Ref Finance | SPOT AMM DEX | CoinAlpha | |
| Sushiswap | SPOT AMM DEX | ||
| Tinyman | SPOT AMM DEX | CoinAlpha | |
| VVS Finance | SPOT AMM DEX | CoinAlpha | |
| WhiteBit | SPOT CLOB CEX | ||
| XSwap | SPOT AMM DEX | CoinAlpha | |
| ZigZag | 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.