Skip to content

dYdX đŸĨ‡

🛠 Connector Info

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

Currently, dYdX is a Gold 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 Not available
🔀 Perp Connector ✅ Supports testnet
đŸ•¯ Spot Candles Feed Not available
đŸ•¯ Perp Candles Feed Not available

ℹī¸ Exchange Info

🔑 How to Connect

Generate API Keys

Create API credentials and a STARK private key using the dYdX documentation:

Alternatively, you can follow these steps to get the required credentials:

  1. From the dYdX exchange, right-click anywhere on your web browser, and select Inspect to open Developer Tools
  2. Go to Application > Local Storage >
  3. Select STARK_KEY_PAIRS and click the drop-down next to your wallet address to get the stark private key
  4. Select API_KEY_PAIRS and click the drop-down next to your wallet address to get the API key, secret key, and passphrase

Add Keys to Hummingbot

You will need the following to connect Hummingbot to dydx_perpetual:

  • API key
  • API secret key
  • Passphrase
  • Account number: set this value to 0
  • Stark private key

From inside the Hummingbot client, run connect dydx_perpetual in Hummingbot in order to connect your wallet:

Enter your dydx_perpetual API key >>>
Enter your dydx_perpetual secret key >>>
Enter your dydx_perpetual passphrase >>>

🔀 Perp Connector

Integration to perpetual futures markets API endpoints

Order Types

This connector supports the following OrderType constants:


Position Modes

This connector supports the following position modes:

  • One-way

Paper Trading

This exchange offers a staging (testnet) mode:

While users can trade on testnet using the link above, it is not currently supported in Hummingbot.