Skip to main content

​
HyperETH API Overview

​
What is HyperETH API?

HyperETH API is a non-custodial, intent-based execution gateway for DEXes including Hyperliquid (Perpetual/Spot CLOB DEX), Aster Perpetual DEX, Uniswap (Spot AMM DEX), and more. This documentation uses Hyperliquid (HL) as the primary example to illustrate the concepts.

​
Core API Categories

V2 Unified APIs

  • /v2/{platform}/*: Unified endpoints for all exchanges
  • Platforms: hyperliquid, aster, lighter
  • Single spec, consistent data models

V1 HL Compatible APIs

  • /v1/hl/info: Fetch market information from HyperETH API, matching HL’s official interface
  • /v1/hl/exchange: Submit pre-signed order requests for broadcast to HL validator nodes

V1 Aster Perp DEX Compatible APIs

  • /v1/aster/fapi/v1: Aster Futures V1 APIs
  • /v1/aster/fapi/v2: Aster Futures V2 APIs

Advanced APIs

  • TEE Protected APIs via Agent Wallet
  • MCP APIs for AI Agent trading

​
V2 Unified API Architecture

The V2 API provides a unified abstraction layer over multiple decentralized exchanges through path-based routing.

​
How It Works

1

Platform Selection

Choose your target exchange via the URL path: /v2/{platform}
  • /v2/hyperliquid - Routes to Hyperliquid
  • /v2/aster - Routes to Aster Perp DEX
  • /v2/lighter - Routes to Lighter Protocol
2

Unified Endpoints

All platforms support the same endpoints:
  • Market data: /getTOB, /getOrderBook, /getSymbolInfo
  • Trading: /placeOrder, /batchPlaceOrder, /cancelOrder, /cancelAllOrders
  • Account: /getBalance, /getPosition, /getOpenOrders, /getUserFills
3

Normalized Responses

Responses use consistent field names and structures across all exchanges
4

Protocol Translation

HyperETH translates between the unified V2 format and each exchange’s native protocol

​
V2 vs V1 APIs

V1 APIs (Exchange-Specific)

  • Separate endpoints per exchange (/v1/hl/*, /v1/aster/*)
  • Exchange-specific request/response formats
  • Direct compatibility with native exchange APIs
  • Ideal for single-exchange integrations

V2 APIs (Unified)

  • Path-based platform routing (/v2/{platform}/*)
  • Normalized, consistent data structures
  • Exchange-agnostic application code
  • Ideal for multi-exchange strategies

​
TEE Protected APIs via Agent Wallet

  • Users submit EIP-712 order intents
  • Aggregator’s Agent Wallet (pre-approved by users on HL) places/cancels orders on their behalf
  • Private keys generated and stored in attested TEE service
  • Pre-liquidation clearing mechanism enabled by default
  • Advanced orders (TWAP, Scale) executed privately without leaking intent

​
System Overview

System Overview

The HyperETH API provides a sophisticated layer above Hyperliquid and other DEXes, offering:
  • Users: Sign and submit EIP-712 intents, monitor unified state
  • Aggregator: TEE-based non-custodial, intent-based execution gateway, schedules advanced orders
  • Settlement: Always on-chain via Hyperliquid orderbook
  • Safety: Non-custodial Agent Wallet, race-avoidance via locks, full auditability

​
API Quick Reference

HL Compatible

  • /v1/hl/info - Market information
  • /v1/hl/exchange - Order submission

Aster Perp DEX Compatible

  • /v1/aster/fapi/v1 - Aster Futures V1 APIs
  • /v1/aster/fapi/v2 - Aster Futures V2 APIs

MCP Integration

  • Unified APIs for AI agents
  • Real-time market data
  • Seamless trade execution