Integration
Trade Hyperliquid with NautilusTrader
Stream Hyperliquid market data and execute perpetual futures and spot markets through an adapter written in Rust, with EIP-712 wallet signing over REST and WebSocket, native trigger orders, and full order and position reconciliation.
Decentralized exchange
Perpetuals and spot
Data and execution
Written in Rust 🦀
Hyperliquid is a decentralized perpetual futures and spot exchange built on the Hyperliquid L1, a purpose-built blockchain that runs a fully on-chain central limit order book. It settles USDC-margined linear perpetuals and native spot markets, reached over REST and WebSocket APIs with one-block finality.
NautilusTrader integrates with Hyperliquid through nautilus-hyperliquid, a platform adapter written in Rust with Python bindings, providing both data and execution clients. It streams order books, quotes, trades, bars, and mark, index, and funding updates, and submits orders signed with EIP-712 typed data in the Rust core rather than calling an external Hyperliquid SDK. Order, fill, position, and balance updates drive reconciliation.
Products
Perpetual futures and spot markets, with opt-in builder-deployed markets, traded through one adapter and signing path.
Perpetual futures
USDC-margined linear
Linear perpetuals settled in USDC on a fully on-chain order book, with native trigger orders for stops and take-profits.
USDC-margined linear contracts
Reduce-only and post-only orders
Stop and take-profit triggers on the mark price
BTC-USD-PERP.HYPERLIQUID
Spot
Tokens against USDC
Native spot markets quoted in USDC on the same L1 order book, reached through the same client and signing path as perpetuals.
Market and limit orders
Quoted against USDC
Shared account and reconciliation
HYPE-USDC-SPOT.HYPERLIQUID
Builder markets
HIP-3 and HIP-4
Opt-in builder-deployed perpetuals and USDH-settled binary outcome markets, loaded by configuration when an account trades them.
HIP-3 builder-deployed perpetuals
HIP-4 binary outcome markets
Enabled per configuration
xyz:TSLA-USD-PERP.HYPERLIQUID
Markets
Crypto majors trade as USDC-margined perpetuals, and many also list against USDC on spot.
Crypto majors · Hundreds of markets
BTC
Bitcoin
ETH
Ethereum
SOL
Solana
HYPE
Hyperliquid
XRP
XRP
BNB
BNB
DOGE
Dogecoin
SUI
Sui
AVAX
Avalanche
LINK
Chainlink
LTC
Litecoin
ARB
Arbitrum
APT
Aptos
NEAR
Near
ADA
Cardano
DOT
Polkadot
ATOM
Cosmos
+ More
Each major lists a USDC-margined perpetual, e.g. BTC-USD-PERP, and many also trade spot against USDC, e.g. HYPE-USDC-SPOT.
These are a representative sample. Hyperliquid lists hundreds more perpetuals and spot pairs and adds new ones continuously, alongside opt-in HIP-3 builder perpetuals and HIP-4 binary outcome markets; the instrument provider discovers the live set at startup and maps every Hyperliquid market to a NautilusTrader instrument.
Capabilities
On-chain order book
Hyperliquid runs a central limit order book directly on its L1, so every order, cancel, and trade settles on chain with one-block finality.
Wallet-based signing
Orders are signed with EIP-712 typed data from an EVM private key, with agent (API) wallets and vault addresses, handled inside the Rust core.
Data and execution
One adapter covers both market data and order execution, with order, fill, position, and balance reconciliation.
Perpetuals and spot
USDC-margined linear perpetuals alongside native spot markets, traded through a single client and signing path.
Builder-deployed markets
Opt-in HIP-3 builder perpetuals and HIP-4 binary outcome markets load by configuration when an account trades them.
Mainnet and testnet
Select the environment with one config flag. The data client runs on public endpoints; execution adds wallet credentials.
Data feeds
Each Hyperliquid feed maps to a native NautilusTrader data type, alongside venue-specific feeds for open interest and mid prices.
Data feed
NautilusTrader type
Notes
Order book (L2)
OrderBookDeltaSnapshot then incremental deltas over WebSocket.
Order book depth
OrderBookDepth10Top-ten levels maintained from the live book.
Quotes
QuoteTickBest bid and offer from the order book.
Trades
TradeTickLive public trades over WebSocket, with REST trade history.
Bars
BarCandles over WebSocket, with REST history.
Mark price
MarkPriceUpdatePerpetual mark price used for triggers and margining.
Index price
IndexPriceUpdateUnderlying index price.
Funding rate
FundingRateUpdatePerpetual funding, with REST history.
Open interest
HyperliquidOpenInterestPer-instrument open interest from the venue.
Mid prices
HyperliquidAllMidsMid price across every active instrument.
Instruments
CurrencyPairCryptoPerpetualSpot pair and perpetual definitions loaded at startup.
Order types
Order types supported per product group. Hyperliquid expresses stops and take-profits as native trigger orders evaluated against the mark price.
Type
Perpetuals
Spot
Notes
Execution features
The execution instructions and account operations traders rely on.
Post-only
Maker-only limit orders using Hyperliquid's add-liquidity-only (ALO) order type, rejected if they would cross the book.
Reduce-only
Position-reducing flag carried on perpetual and spot orders so an order can only close exposure.
Trigger orders
Stops and if-touched orders use Hyperliquid's native triggers, evaluated against the mark price with automatic take-profit and stop-loss detection.
Order amendment
Modify price or quantity through a cancel-and-replace that preserves the order's identity for the strategy.
Batch operations
Submit order lists and cancel by client order ID in single batched requests.
Builder attribution
Mainnet orders carry the NautilusTrader builder code at a zero fee rate after a one-time on-chain approval.
Data and execution clients
Data client
Public REST and WebSocket streams
Feeds: order books, top-ten depth, quotes, trades, bars, mark and index prices, funding, and open interest.
No credentials: public market data runs on public endpoints, so research and backtest data need no wallet.
Resilience: reconnecting WebSocket with subscription tracking and exponential backoff.
Execution client
Wallet-signed orders over REST and WebSocket
Orders: EIP-712 signed entry, cancel-replace amend, order-list batches, and native triggers for stops and take-profits.
Account: order, fill, position, and balance updates drive reconciliation.
Wallets: trade from an EVM key directly or through an agent (API) wallet and an optional vault address.
How the integration works
Adapter crate
Data client
HyperliquidDataClient streams instruments, books, quotes, trades, and bars.Execution client
HyperliquidExecutionClient handles signed orders, account queries, and reconciliation.Signing
Instrument types
Environments
HyperliquidEnvironment.Authentication
Considerations
Public market data needs no credentials; execution signs with an EVM private key, optionally through an agent (API) wallet and a vault address.
Hyperliquid runs an on-chain central limit order book on its own L1; orders are signed off-chain with EIP-712 typed data and submitted over REST and WebSocket.
Time in force is GTC or IOC; FOK and GTD are not supported by the venue, and post-only maps to the ALO order type.
Market orders submit as IOC limit orders with a configurable slippage bound, defaulting to 50 basis points.
Conditional orders use native trigger orders evaluated against the mark price, with automatic take-profit and stop-loss detection.
Order modification runs as cancel-and-replace, preserving the strategy's order identity.
HIP-3 builder perpetuals and HIP-4 binary outcome markets are opt-in and loaded by configuration.
Mainnet orders carry the NautilusTrader builder code at a zero fee rate after a one-time on-chain approval, so attribution adds no trading cost.
Quickstarts
Starting points for the Hyperliquid adapter.
Read the integration guide
Installation, wallet setup, configuration, EIP-712 signing, and order handling for the Hyperliquid adapter.
Read guide
Rust adapter examples
Runnable example nodes bundled with the crate: market-data and execution testers, plus an outcome-market execution tester.
View on GitHub
Integration guide
Read the full integration guide
The guide covers installation, wallet setup, configuration, order handling, EIP-712 signing, and worked examples for trading Hyperliquid.
NautilusTraderâ„¢ is a product of Nautech Systems Pty Ltd (ABN 88 609 589 237). Nautech Systems provides algorithmic trading software only. We do not operate as a broker, dealer, or exchange, nor offer financial advisory services. Users are solely responsible for compliance with applicable laws and regulations. Subject to non-excludable consumer guarantees, we make no warranties and accept no liability for trading losses or regulatory violations arising from use of the software. Read full disclaimer.
We use essential cookies and, with your consent, optional analytics cookies, as described in our Privacy Policy. Manage your Cookie Preferences.