Skip to content


Support Hummingbot

Hummingbot Foundation has a fee share partnership with Ascendex. When you use our software to trade on Ascendex, a custom API header tells Ascendex that the trade was executed using Hummingbot, so they share a portion of your fees with us, at no cost to you. To support us, just enter your API keys into Hummingbot and run bots! Thanks for your support! 🙏

🛠 Connector Info

  • Exchange Type: Centralized Exchange (CEX)
  • Market Type: Central Limit Order Book (CLOB)
  • Maintenance Tier:
  • Maintainer: Hummingbot Foundation

Currently, Ascendex is a Silver exchange, as voted by HBOT holders in each quarterly Epoch. This means that Hummingbot Foundation maintains the components below via Bounties, tracking improvements made to the Gold exchange connectors of that type.

Component Status Notes
🔀 Spot Connector ✅ Supports MARKET order type
🔀 Perp Connector Not built API only allows institutional accounts
đŸ•¯ Spot Candles Feed ✅
đŸ•¯ Perp Candles Feed Not built

ℹī¸ Exchange Info

🔑 How to Connect

Generate API Keys

Log in to your AscendEX account using your PC and visit profile icon – [API Setting].

Create API

Click [New API Key] in the upper right corner of the page.


Create a name for the new API key and set up API permissions and IP address restrictions. Complete a three-step verification by entering your phone, email, and Google verification code. Click [Generate API Key] to complete the process.

Create API name

A pop-up containing both public and private API keys will appear on your screen. Please keep a copy of both keys, as they will only be viewable to you during this stage of the setup. For account security, never share your API keys. In the case of a lost or forgotten API key, it is advised to delete the old API and create new keys immediately.

API text

After creating an API key, you can Edit or Delete your API keys under the Action tab.

API Done


  • API keys without an IP address will only remain valid for 365 days.
  • Up to 20 IP addresses can be bound to one API key.
  • For security enhancement, it is recommended that only IP addresses in users API's whitelist make API calls to users' network. An "unrestricted" setting will allow all IPs to access the network, decreasing account security.
  • Multiple IP addresses must be separated by half-width commas during the setup.

Add Keys to Hummingbot

>>> connect ascendex

Enter your ascendex API key >>>
Enter your ascendex secret key >>>

If connection is successful:

You are now connected to ascendex

🔀 Spot Connector

Integration to spot markets API endpoints

Order Types

This connector supports the following OrderType constants:


Paper Trading

Access the Paper Trade version of this connector by running connect ascendex_paper_trade instead of connect ascendex.

If this is not available by default, you can configure Hummingbot to add this paper trade exchange. See Adding Exchanges for more information.

đŸ•¯ Spot Candles Feed

Collect historical OHCLV data from this exchange's spot markets


In a Hummingbot script, import CandlesFactory to create the candles that you want:

    from hummingbot.data_feed.candles_feed.candles_factory import CandlesFactory
    candles = CandlesFactory.get_candle(connector="ascendex",
                                        interval="1m", max_records=50)

See for more details.