DocsMigration from Testnet

Migration from Testnet

Migrate your existing Hyperliquid testnet code to PaperExchange in minutes. Test with real mainnet data instead of fake testnet prices.

Why Migrate from Testnet?

Hyperliquid Testnet

  • • Fake, simulated price data
  • • Artificial order books
  • • No real market volatility
  • • Strategies may fail on mainnet
  • • False confidence in results

PaperExchange

  • • Real mainnet price data
  • • Actual order book depth
  • • True market conditions
  • • Validated strategy performance
  • • Confidence before going live

Migration Steps

1

Create a PaperExchange Account

Sign up for a free 3-day trial. No credit card required.

Create Account
2

Generate an API Key

Go to your dashboard and create an API key. Copy it securely.

pe_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

Update Your Code

Make these two simple changes to your existing code:

Change 1: Update Base URL

BASE_URL = "https://api.hyperliquid-testnet.xyz"
BASE_URL = "https://api.paperx.co"

Change 2: Add API Key Header

headers = {"X-API-Key": "pe_your_api_key"}
4

Test Your Strategy

Run your strategy and see how it performs with real mainnet data. Your positions and orders work exactly like on Hyperliquid.

Code Comparison

Before (Testnet)

import requests

BASE_URL = "https://api.hyperliquid-testnet.xyz"

response = requests.post(
    f"{BASE_URL}/v1/exchanges/hyperliquid/info",
    json={"type": "allMids"}
)

print(response.json())

After (PaperExchange)

import requests

BASE_URL = "https://api.paperx.co"
API_KEY = "pe_your_api_key"

response = requests.post(
    f"{BASE_URL}/v1/exchanges/hyperliquid/info",
    headers={"X-API-Key": API_KEY},
    json={"type": "allMids"}
)

print(response.json())

API Compatibility

PaperExchange API v1.0 is 100% compatible with Hyperliquid's API. All endpoints, request formats, and response structures are identical.

Supported Endpoints

Info Endpoint

  • ✓ allMids
  • ✓ meta
  • ✓ l2Book
  • ✓ clearinghouseState
  • ✓ openOrders
  • ✓ userFills
  • ✓ userFillsByTime
  • ✓ orderStatus
  • ✓ historicalOrders
  • ✓ userRateLimit
  • ✓ candleSnapshot
  • ✓ spotMeta

Exchange Endpoint

  • ✓ order (all types)
  • ✓ cancel
  • ✓ cancelByCloid
  • ✓ modify
  • ✓ batchModify
  • ✓ updateLeverage
  • ✓ updateIsolatedMargin
  • ✓ usdClassTransfer
  • ✓ twapOrder
  • ✓ twapCancel
  • ✓ scheduleCancel
  • ✓ Trigger orders (TP/SL)

Key Differences from Testnet

Authentication Required

PaperExchange requires API key authentication. Testnet doesn't require auth for public endpoints.

Real Mainnet Data

Prices and order books come from Hyperliquid mainnet, not simulated data.

Paper Trading Only

All trades are simulated. No real funds are at risk.

Account Balance

You start with $10,000 (Basic) or $100,000 (Pro) virtual balance. Can be topped up when balance falls below $100.

Ready to Migrate?

Create your account and start testing with real mainnet data in minutes.

Start Free Trial