Skip to main content

Hyperliquid configuration

Hyperliquid is currently the only exchange supported by HyperVibes because of its worldwide availability and straightforward integration for AI agents.

Register with Hyperliquid​

Before using HyperVibes, register the wallet you use to sign in with Hyperliquid:

  1. Open Hyperliquid and connect the same wallet you use to sign in to HyperVibes. The wallet must be on Arbitrum.
  2. Choose Enable Trading in Hyperliquid and sign the gas-less transaction.
  3. Make the first deposit requested by Hyperliquid, with at least $5 USDC.
  4. Return to HyperVibes and refresh the Account page.

See Hyperliquid's onboarding and trading guide for its current wallet connection and deposit instructions. Its USDC documentation explains how USDC moves onto HyperCore.

Connecting a wallet alone does not activate a Hyperliquid trading account. The Account page must show the wallet as registered before you can set up an API key, approve a builder fee, or create an agent.

HyperVibes currently supports Hyperliquid Unified Accounts. Your main account and its sub-accounts use the shared Unified USDC balance shown on the Account page.

API Keys​

Hyperliquid API keys, also called API wallets or agent wallets, are signing wallets that can place orders on behalf of your main account or its sub- accounts. They do not hold funds. Your main wallet remains the owner and is used for login, approvals, and account transfers.

See Hyperliquid's API wallet documentation for the exchange-level API wallet model and expiry behavior.

HyperVibes recommends generating the API key from the Account page:

  1. Select Generate API Key.
  2. HyperVibes creates a new signing key and stores it encrypted.
  3. Approve the key with your main wallet when Hyperliquid requests approval.

You can instead select Import existing API key and provide a key that you generated manually on Hyperliquid's web site. HyperVibes checks that the key matches its derived address and stores the private key encrypted. Only import a key when you understand where it came from and who has had access to it.

API keys expire after six months. Rotate an expiring or expired key from the Account page by generating a fresh key and approving it with your main wallet. Do not reuse a key that has expired or been deregistered. HyperVibes uses the API key for exchange signing; it never gives the key to an agent workspace and the key does not custody your funds.

Accounts and sub-accounts​

An agent must be assigned exactly one exclusive Hyperliquid trading account. That account can be your main account or one of your sub-accounts. No two agents can share the same account. The agent's positions, orders, balances, and transaction history are kept separate from every other agent's account.

Sub-accounts remain owned by the main account but provide separate trading boundaries. Hyperliquid allows up to 10 sub-accounts after the main account reaches $100,000 in trading volume. Every additional $100 million in volume allows one more sub-account, up to a maximum of 50. Hyperliquid's sub-account limit is based on the main account's cumulative volume.

See Hyperliquid's sub-account documentation for the current volume thresholds and sub-account limits.

After you have an approved API key and enough sub-account capacity, HyperVibes can create a named sub-account while you create an agent. The application assigns the new account to that agent after Hyperliquid confirms it. You can also assign an existing unassigned main account or sub-account from the agent setup page.

Sub-accounts use the main account's fee tier, but Hyperliquid referral discounts do not apply to sub-accounts.

Transactions and trade journal​

HyperVibes imports Hyperliquid account activity for each agent's assigned account. Open the agent's Transactions tab to switch between Trades (the default view) and Activity.

Trades​

The Trades view groups perpetual fills into long or short trades, from opening a position to closing it. Adding to a position or partially closing it stays within the same trade. Reversing direction closes one trade and starts another. Open trades appear as soon as their opening fills are imported; they do not need to close first. Live fills update the trade's status and realized results.

Each trade shows its status, entry and exit prices, realized profit or loss, trading fees, and funding. Net realized is realized profit or loss minus trading fees, plus funding received or minus funding paid. For open trades, these amounts are realized results so far; they do not include unrealized profit or loss.

Values marked Incomplete mean the available history or fee information is insufficient to calculate a complete result.

Activity​

Activity shows individual account events in a chronological ledger, including:

  • trades and fills
  • trading fees and realized profit or loss
  • funding payments
  • deposits, withdrawals, and account transfers
  • other Hyperliquid ledger changes

The running balance reflects USDC movements in the available history. It may differ from the current account balance if older history is missing. A balance marked Incomplete means an event's effect on the balance could not be determined.

Transactions are historical account activity. Current positions and open orders are shown separately on the agent page, while the transaction ledger remains the account's historical record. Hyperliquid's historical data documentation describes the exchange's own historical-data sources.

Journal notes​

Select the notes icon beside a trade or transaction to read or add notes. Trade notes also let you inspect the individual fills. Each note shows its author and time, and saved notes cannot be edited or deleted.

Review agents can add notes as part of their review. To let a Chat conversation add notes, set its Trade notes permission to Allow.

Indicator candle data​

Indicators use complete OHLCV candle snapshots fetched server-side from Hyperliquid's public market-data endpoint. HyperVibes sorts and validates the series, runs indicator source only on candles closed at the scheduled boundary, and persists the normalized candle input with each run. The browser chart reads that persisted run data, so it reflects the exact candles that produced the indicator values rather than a live or client-side price cache.

Builder Fee​

A builder fee approval is required before HyperVibes can place eligible perpetual orders. The fee supports ongoing HyperVibes development and is collected on eligible orders submitted through the application.

Hyperliquid explains builder-code approvals and limits in its builder code documentation. Its general fee documentation covers exchange trading fees separately from the HyperVibes builder fee.

The builder fee must be set between 1 basis point (0.01%) and 10 basis points (0.10%).

Your main wallet signs the approval. You can change or cancel the approval from the Account page. The selected fee is applied to eligible orders for your account.

Referral Discount​

The referral discount is optional. Eligible users can follow the HyperVibes link from the Account page to Hyperliquid, connect the same main wallet, and apply the code there for an additional 4% discount on Hyperliquid fees. Confirm that Hyperliquid shows HYPERVIBES before approving it; a wallet may offer a different code.

The main account must have less than $10,000 in cumulative trading volume and must not already have a referral code. The discount is offered only while the account remains eligible. Refresh the Account page after applying the code to confirm Hyperliquid reports it; the offer will disappear. Referral discounts do not apply to sub-accounts. See Hyperliquid's referral documentation for its current referral terms.