Hyperliquid API

Test your Hyperliquid strategies with real mainnet data. Just change the URL - your existing code works instantly.

Why not use Hyperliquid Testnet?

Hyperliquid's testnet uses fake, simulated data. Strategies that work on testnet often fail on mainnet because the prices, order books, and market conditions are completely different. PaperExchange connects to real mainnet data so your testing reflects actual market behavior.

Quick Start

Get up and running in 5 minutes

API Reference

Complete endpoint documentation

WebSocket API

Real-time price and order updates

Backtesting

Test strategies on historical data

Advanced Orders

TP/SL, TWAP, and trigger orders

Migration Guide

Move from testnet to PaperExchange

Getting Started

1Create an Account

2Generate an API Key

Go to your Hyperliquid dashboard and create an API key. You can create up to 5 keys on the Basic plan.

API Key: pe_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

3Make Your First Request

Use your API key to make requests. The API is fully compatible with Hyperliquid.

curl -X POST https://api.paperx.co/v1/exchanges/hyperliquid/info \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pe_your_api_key" \
  -d '{"type": "clearinghouseState"}'

Key Concepts

API Compatibility

We use the same API format as Hyperliquid. Change the base URL from api.hyperliquid.xyz to api.paperx.co/v1/exchanges/hyperliquid and add your API key.

Authentication

All requests require an API key passed in the X-API-Key header. You can also use Bearer token authentication with your JWT.

Paper Trading

All trades are simulated using real mainnet data. Basic: $10,000, Pro: $100,000 virtual balance. Fees and slippage are simulated realistically.

Rate Limits

Basic plan: 200 requests/minute. Pro plan: 500 requests/minute. Rate limit headers are included in all responses.

Endpoints Overview

Endpoint	Method	Description
`/v1/exchanges/hyperliquid/info`	POST	Get market data and account info
`/v1/exchanges/hyperliquid/exchange`	POST	Place and cancel orders
`/v1/exchanges/hyperliquid/ws`	WS	WebSocket for real-time updates
`/v1/exchanges/hyperliquid/account/overview`	GET	Get account dashboard
`/v1/exchanges/hyperliquid/backtest/backtests`	POST	Run strategy backtests
`/v1/exchanges/hyperliquid/backtest/ohlcv/sync`	POST	Sync historical OHLCV data
`/v1/auth/api-keys`	POST	Create API key (global)
`/v1/billing/subscription`	GET	Get subscription status (global)

View full API reference