​
How Testnet Works

Every REST endpoint in the Provider API has a testnet variant. Simply prefix the path with /testnet/:
EnvironmentURL Pattern
Mainnethttps://api.perps.studio/v1/perps/:provider/markets
Testnethttps://api.perps.studio/v1/testnet/perps/:provider/markets
The request and response format is identical — only the underlying network changes. 
curl -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/perps/hyperliquid/markets

​
Provider Testnet Support

ProviderTestnet AvailableTestnet Network
HyperliquidYesHyperliquid Testnet L1
Aster DEXYesAster Testnet
PolymarketNoN/A
Polymarket does not have a testnet. Prediction market endpoints only work on mainnet.

​
Getting Testnet Tokens

​
Hyperliquid Testnet

  1. Go to app.hyperliquid-testnet.xyz
  2. Connect your wallet
  3. Use the built-in faucet to get testnet USDC

​
Aster Testnet

  1. Go to testnet.aster.finance
  2. Connect your wallet
  3. Claim testnet tokens from the faucet

​
Testnet Differences

Testnet markets may differ from mainnet. Some assets may be unavailable, and liquidity will be significantly lower. Order execution may behave differently due to low volume.
Key differences to be aware of:
  • Fewer markets — testnets typically list a subset of mainnet markets
  • Low liquidity — orderbooks are thin; large orders will have significant slippage
  • Intermittent availability — testnets may experience downtime or resets
  • Different asset IDs — internal identifiers (e.g., Hyperliquid asset indices) differ between mainnet and testnet
1

Develop on Testnet

Build and iterate using testnet endpoints. Verify market data fetching, order placement, and position management.
2

Validate Order Flow

Place test orders, verify fills, check positions, and cancel orders. Ensure your error handling covers all cases.
3

Switch to Mainnet

Remove the /testnet/ prefix from your base URL. No other code changes needed.