HyperETH Trading API

HyperETH provides a comprehensive trading API to multiple decentralized exchanges, including:

• Hyperliquid - a high-performance Layer 1 blockchain focused on decentralized perpetual and spot trading with 200,000+ orders per second capacity.
• Aster DEX - a decentralized exchange that unifies advanced perpetual and spot trading, deep on-chain liquidity, and yield products into a seamless, user-centric DeFi ecosystem.
• Lighter Protocol - a perpetual futures DEX built as an application-specific zk-rollup on Ethereum, using custom ZK-SNARK circuits for verifiable order book matching with CEX-level performance (10,000 orders/sec, 5ms latency) and zero trading fees for retail users.
• Kuru Protocol - a fully onchain central-limit order book (CLOB) spot DEX on Monad, leveraging Monad's high throughput (~10,000 TPS) with a hybrid CLOB-AMM model that unifies ecosystem liquidity for CEX-like execution.
• Hyena - a capital-efficient perpetual futures DEX built on Hyperliquid's HIP-3 (Builder-Deployed Perpetuals) framework, using Ethena's USDe as yield-bearing collateral with deeply reduced trading fees.
• GRVT - a hybrid decentralized exchange built as the first appchain on ZKsync's ZK Stack, combining an off-chain CLOB with on-chain ZK-proof settlement for CEX-grade performance (600K TPS, sub-2ms latency) with self-custody and MEV protection.
• Nado - a high-performance orderbook DEX on Ink (Kraken's Optimism-based Ethereum L2) offering unified cross-margin across spot, perpetuals, and money markets with 5-15ms execution latency.
• Paradex - a perpetuals DEX built as the first Starknet appchain, leveraging ZK-STARK proofs for Ethereum-secured settlement with privacy-preserving encrypted accounts, zero retail trading fees, and 250+ markets.

HyperETH Trading API V2

The V2 API introduces a unified specification that works across multiple decentralized exchanges. Instead of learning different API interfaces for each DEX, you can use a single, consistent API to trade on all supported exchanges.

Unified Interface Benefits

• Single API specification for all supported DEXes
• Consistent request/response formats across exchanges
• Streamlined integration - write once, trade everywhere
• Path-based routing to specify your target DEX (/v2/{platform})
• Identical authentication via X-API-KEY header

Whether you're trading on Hyperliquid, Aster, or any other supported exchange, the V2 API provides the same endpoints, data structures, and WebSocket channels - just specify which platform you want to trade on.

Key Features

• On-chain Order Book: 200,000+ orders per second capacity
• Multi-DEX Support: Trade across 8 decentralized exchanges through one API
• Perpetual Futures & Spot Trading: Full trading capabilities
• Real-time WebSocket Streaming: Live market data and account updates
• Advanced Order Types: Support for complex trading strategies (TWAP, Scale, etc.)
• Cross-DEX Aggregation: Aggregated balances and cross-exchange arbitrage strategies
• Robust Risk Management: Built-in safety mechanisms with pre-liquidation clearing
• Agent Access: Self-service registration and venue configuration for AI agents and programmatic users — register via wallet signature, configure venues, and trade across 8 DEXes

Getting Started

Base URLs

Unified REST API

https://api.hypereth.io/v2/{platform}

Replace {platform} with one of: hyperliquid, aster, lighter, kuru, hyena, grvt, nado, paradex

Unified WebSocket API

wss://api.hypereth.io/v2/{platform}/ws

For authenticated channels, append your API key:

wss://api.hypereth.io/v2/{platform}/ws?apiKey=YOUR_API_KEY

Cross-DEX Aggregation

https://api.hypereth.io/v2/all
wss://api.hypereth.io/v2/all/ws

Agent Access

https://api.hypereth.io/v2/account

Supported Platforms

Authentication

All V2 API requests require an API key passed via the X-API-KEY header:

curl -H "X-API-KEY: your_api_key" https://api.hypereth.io/v2/hyperliquid/getTOB

To obtain an API key, register via the Agent Access API using an EIP-191 wallet signature.

Rate Limits

Rate limits vary by platform:

• Hyperliquid: 1,200 weight per minute (IP-based), 100 WebSocket connections, 1,000 subscriptions
• Aster: Per-IP request weight tracking via response headers, per-account order rate limits
• Other platforms: Refer to platform-specific documentation

API Types

REST API

Use our REST API for:

• Account management
• Order placement and cancellation
• Historical data queries
• Portfolio analysis

Browse the REST API endpoints in the navigation sidebar.

WebSocket API

Use our WebSocket API for:

• Real-time market data streaming
• Live account updates
• Order and trade notifications
• Funding and liquidation events

Browse the WebSocket API channels in the navigation sidebar.

Support

For technical support and questions, please reach out through our community channels or contact our support team.