Skip to content

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
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
Himalaya SPOT CLOB CEX
NDAX SPOT CLOB CEX
LBank SPOT CLOB CEX
MM Finance SPOT AMM DEX
Pangolin SPOT AMM DEX
Ref Finance SPOT AMM DEX
Trader Joe SPOT AMM DEX
VVS Finance 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.