Core Concepts

Non-custodial unified execution gateway for multi-DEX trading with TEE-protected credentials

What is HyperETH API?

HyperETH API is a non-custodial unified execution gateway for multi-DEX trading across Hyperliquid, Aster, Lighter, Kuru, Hyena, GRVT, Nado, Paradex, and dynamic HIP-3 DEXes. The V2 interface keeps request and response shapes consistent across supported venues.

Core API Categories

V2 Unified Trading APIs

/v2/{platform}/*: Unified endpoints for all exchanges
Platforms: hyperliquid, aster, lighter, kuru, hyena, grvt, nado, paradex
/v2/hip3/{dexname}/*: Dynamic HIP-3 DEXes on Hyperliquid
Single spec, consistent data models

V2 Cross-DEX Aggregation

/v2/all/balances: Aggregated balances across all DEXes
/v2/all/strategy/*: Cross-exchange arbitrage strategies

V2 Agent Access APIs

/v2/account/register: Wallet registration via EIP-191 signature
/v2/account/venues: Venue credential setup and management
/v2/account/api-keys: API key lifecycle management

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

Choose your target exchange via the URL path: /v2/{platform}

/v2/hyperliquid - Routes to Hyperliquid
/v2/aster - Routes to Aster DEX
/v2/lighter - Routes to Lighter Protocol
/v2/kuru - Routes to Kuru Protocol (Spot DEX)
/v2/hyena - Routes to Hyena
/v2/grvt - Routes to GRVT
/v2/nado - Routes to Nado
/v2/paradex - Routes to Paradex
/v2/hip3/{dexname} - Routes to any HIP-3 DEX (dynamic, use /v2/hyperliquid/getHip3Dexes to discover)

All platforms support the same endpoints:

Market data: /getTOB, /getOrderBook, /getSymbolInfo
Trading: /placeOrder, /batchPlaceOrder, /cancelOrder, /cancelAllOrders
Account: /getBalance, /getPosition, /getOpenOrders, /getUserFills

Responses use consistent field names and structures across all exchanges

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

The HyperETH API provides a unified layer above supported DEXes, offering:

Clients: Authenticate with API keys and use the same V2 interface across venues
Routing: HyperETH normalizes requests and routes them to the selected platform
Settlement: Orders settle on the target exchange
Safety: TEE-protected credential handling, venue-specific permission models, and auditable state changes

Agent Access Architecture

Agent Access enables dynamic, self-service credential management for external agents. Instead of requiring static configuration at startup, agents register via wallet signature and manage venue credentials at runtime.

Dynamic Credential Management

Agents register via EIP-191 wallet signature
Venue credentials encrypted with AES-256-GCM
Hot reload: credentials loaded from DB at runtime
Coexists with existing static configuration

Two Venue Models

Prepare + Confirm (HL/HyENA/Aster/Paradex/GRVT): Generated keypair + UI confirmation
User Credentials (Lighter/Kuru/Nado): Direct credential submission

API Quick Reference

Unified Trading

/v2/{platform}/placeOrder - Place orders
/v2/{platform}/getOrderBook - Order book data
/v2/{platform}/getBalance - Account balance

Cross-DEX & Strategy

/v2/all/balances - Aggregated balances
/v2/all/strategy/submit/* - Strategy submission
/v2/all/strategy/status/* - Strategy monitoring

Agent Access & MCP

/v2/account/register - Wallet registration
/v2/account/venues - Venue management
MCP APIs for AI agent trading