Skip to main content

Tutorial: Testnet Funding and Faucet

Step-by-step guide to funding your testnet account in the app and understanding testnet behavior.

Prerequisites​

  • Testnet account (wallet address)
  • Access to Hypercall testnet environment
  • Understanding of testnet vs production differences

Testnet Environment​

Chain ID: 998 (Hyperliquid testnet)

Step 1: Request test tokens​

  1. Tap "Get Test USDH"

Faucet flow

Step 2: Create agent key​

Create agent key

Step 3: Confirm funding & Browse Markets​

  1. Confirm funding by looking at the bottom left corner of the main screen
  2. Tap underlying to open market pages

Confirm funding

Step 4: You're ready to trade​

  1. Place an order (see Tutorial: First Trade)
  2. Verify the order is accepted
  3. Check the portfolio after a fill to see updated cash balance

Step 5: Understand testnet limitations​

Rate Limiting​

Status: Rate limiting is not enforced on testnet.

Recommendation: Self-throttle to avoid abuse (10 to 50 requests per second recommended).

Market Data​

Source: Real Hyperliquid spot prices via WebSocket feed.

Behavior: Market data should be accurate, but testnet may have different liquidity than production.

Common Issues​

"Account has no funds" on testnet​

Cause: Account may not have been created yet, or balance was reset.

Fix:

  • Reconnect your wallet in the app
  • Reopen the wallet drawer to refresh the balance
  • If balance is still zero, check if testnet default behavior changed

"API key required"​

Cause: The app prompts for an API key before trading.

Fix: Follow the in-app prompt to create or connect an API key, then return to the wallet drawer.

"API key has no funds"​

Cause: The API key is connected but the balance is still zero.

Fix: Complete the faucet flow above and refresh the wallet drawer.

"I want to reset my testnet account"​

Use a different wallet address to create a new account.

"How do I get more testnet funds?"​

Use the faucet flow above to request more test tokens.

See also​