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 Perp DEX - a decentralized perpetual exchange that unifies advanced trading, deep on-chain liquidity, and yield products into a seamless, user-centric DeFi ecosystem.

​

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 Hyperliquid, Aster, and other supported exchanges.

​

Unified Interface Benefits

• Single API specification for all supported DEXes
• Consistent request/response formats across exchanges
• Streamlined integration - write once, trade everywhere
• Exchange parameter in requests to specify your target DEX
• Identical authentication and signing mechanisms

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

​

Key Features

• On-chain Order Book: 200,000+ orders per second capacity
• 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
• Robust Risk Management: Built-in safety mechanisms

​

Getting Started

​

Hyperliquid

​

Base URLs

• Mainnet(REST): https://api.hypereth.io/v1/hl
• Mainnet(Websocket): wss://api.hypereth.io/v1/hl/ws

​

Rate Limits

• IP-based: 1,200 weight per minute (aggregated across all requests)
• Address-based: 1 request per 1 USDC traded cumulatively
• WebSocket: 100 connections, 1,000 subscriptions maximum

​

Aster Perp DEX

​

Base URLs

• Mainnet(REST): https://api.hypereth.io/v1/aster
• Mainnet(Websocket): wss://api.hypereth.io/v1/aster/perp/ws

​

Rate Limits

• IP-based: The API enforces rate limits per IP address, tracks “request weight” usage via headers
• Order rate limits: Order submissions are limited per account, and each response includes a header showing how many orders the account has placed in a given interval

​

Authentication

All exchange operations require cryptographic signatures. We recommend using official SDKs when possible to avoid common signing pitfalls.

​

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.