PaperExchange Documentation
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
Authentication
API keys and JWT tokens
API Reference
Complete endpoint documentation
Migration Guide
Move from testnet to PaperExchange
Getting Started
1Create an Account
Sign up for PaperExchange and start your 3-day free trial. No payment required.
Sign up now2Generate an API Key
Go to your dashboard and create an API key. You can create up to 5 keys on the Basic plan.
API Key: pe_xxxxxxxxxxxxxxxxxxxxxxxxxxxx3Make 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
PaperExchange uses 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/auth/register | POST | Create a new account |
/v1/auth/login | POST | Login and get JWT token |
/v1/auth/api-keys | POST | Create API key |
/v1/exchanges/hyperliquid/account/overview | GET | Get account dashboard |
/v1/exchanges/hyperliquid/account/funding | GET | Get funding payment history |
/v1/exchanges/hyperliquid/account/liquidations | GET | Get liquidation history |
/v1/exchanges/hyperliquid/account/reset | POST | Add funds when balance low |
/v1/billing/subscription | GET | Get subscription status |