Skip to content

Hyperliquid

🛠 Connector Info

  • Exchange Type: Decentralized Exchange (DEX)
  • Market Type: Central Limit Order Book (CLOB)
Component Status Notes
🔀 Spot Connector ✅
🔀 Perp Connector ✅ Supports testnet
đŸ•¯ Spot Candles Feed ✅
đŸ•¯ Perp Candles Feed ✅
📓 Connector Guide ✅

ℹī¸ Exchange Info

🔑 How to Connect

Tip

See the Hyperliquid Vault Guide for more details on how to use Hyperliquid VauLts.

Add Keys to Hummingbot

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

Enter your Arbitrum wallet address >>>
Enter your Arbitrum wallet private key >>>

If connection is successful:

You are now connected to hyperliquid.

🔀 Spot Connector

Integration to spot markets API endpoints

Order Types

This connector supports the following OrderType constants:

  • LIMIT
  • LIMIT_MAKER
  • MARKET

🔀 Perp Connector

Integration to perpetual futures markets API endpoints

Usage

From inside the Hummingbot client, run connect hyperliquid_perpetual:

>>> connect hyperliquid_perpetual
Enter your Arbitrum wallet address >>>
Enter your Arbitrum wallet private key >>>

If connection is successful:

You are now connected to hyperliquid_perpetual

Order Types

This connector supports the following OrderType constants:

  • LIMIT
  • LIMIT_MAKER
  • MARKET

Position Modes

This connector supports the following position modes:

  • One-way

Paper Trading

This perp exchange offers a paper trading mode: https://app.hyperliquid-testnet.xyz/trade

Afer you create an account and create the API keys, you can enter them by using the connect hyperliquid_perpetual_testnet command within the Hummingbot client. Once connected, you should be able to use the testnet with the available perpetual strategies / scripts.

đŸ•¯ Spot Candles Feed

OHLCV candles data collector from spot markets

Usage

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="hyperliquid",
                                        trading_pair="ETH-USDT",
                                        interval="1m", max_records=50)

đŸ•¯ Perp Candles Feed

OHLCV candles data collector from perpetual futures markets

  • ID: hyperliquid_perpetual
  • Supported Intervals: 1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 1w | 1M
  • Github Folder

Usage

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="hyperliquid_perpetual",
                                        trading_pair=trading_pair,
                                        interval="3m", max_records=50)