Wallet Setup

Hyperliquid authentication in this client is wallet-based, not API-key based.

Public Usage

No credentials are required for:

Exchange and Hyperliquid sign requests with an Ethereum private key.

The simplest setup is:

export HYPERLIQUID_PRIVATE_KEY="your_private_key"

Then:

from hyperliquid import Hyperliquid

async with Hyperliquid.http() as client:
  result = await client.exchange.noop()

You can also pass a wallet or private key directly:

from hyperliquid import Hyperliquid

async with Hyperliquid.http('0xyour_private_key') as client:
  result = await client.exchange.noop()

If you only need signed actions, you can instantiate Exchange directly with a wallet object.

never commit your private key
treat HYPERLIQUID_PRIVATE_KEY as a high-sensitivity secret
keep public read workflows on Info or Streams whenever possible
treat exchange examples as mainnet-sensitive unless you explicitly set mainnet=False