Hyperliquid Account Diagnostics

Use this guide when a Hyperliquid balance, open order, deposit, agent wallet, or active EVM wallet looks wrong. These commands collect support-safe state before any live mutation. They do not place orders, approve agents, send funds, withdraw, or submit exchange actions.

Start With The Active Account

Start with the active Bullpen EVM wallet. The command is read-only and emits positions, margin state, and the authenticated signer when the account comes from login state.

bullpen hl status --output json

Then capture balances and open orders for the same account. These are read-only account reads. JSON mode keeps multi-wallet warnings out of stderr.

bullpen hl balances --output json
bullpen hl orders --output json

A funded account reports positions and a populated margin summary; a brand-new account that has never deposited reports zero margin and no positions. Both are healthy read-only /info reads — "no funds yet" is not an error.

Example output — funded vs no funds yet

Funded account (`bullpen hl status --output json`):

{
  "address": "0xABC…1234",
  "positions": [
    {
      "coin": "BTC",
      "side": "long",
      "size": "0.01",
      "entry_px": "65000",
      "mark_px": "66250",
      "unrealized_pnl": "12.5",
      "leverage": "cross 5x"
    }
  ],
  "margin_summary": {
    "accountValue": "1250.50",
    "totalNtlPos": "500.00",
    "totalMarginUsed": "125.00"
  }
}

No funds yet (`bullpen hl status --output json`):

{
  "address": "0xABC…1234",
  "positions": [],
  "margin_summary": {
    "accountValue": "0.0",
    "totalNtlPos": "0.0",
    "totalMarginUsed": "0.0"
  }
}

Balances follow the same shape (`bullpen hl balances --output json`):

{
  "schema_version": 1,
  "address": "0xABC…1234",
  "perp_account_value": "0.0",
  "available_usdc": "0.0",
  "spot_estimated_value": "0.0",
  "estimated_total_equity": "0.0",
  "spot_balances": []
}

Compare A Specific Address

If support asks you to inspect a specific EVM address instead of the active wallet, pass the address explicitly. Explicit address reads are public account reads and omit signer_address in JSON.

bullpen hl status --address <EVM_ADDRESS> --output json
bullpen hl balances --address <EVM_ADDRESS> --output json
bullpen hl orders --address <EVM_ADDRESS> --output json

Capture HIP-3 DEX Scope

For HIP-3 DEX scope questions, capture the registered DEX list before an all-DEX account read.

bullpen hl perp-dexes --output json
bullpen hl status --all-dexes --output json
bullpen hl balances --all-dexes --output json
bullpen hl orders --all-dexes --output json

Regular bullpen hl status --output json reports the main perps account shape: address, optional signer_address, positions, and margin_summary. The all-DEX status command returns the separate all-DEX report shape with kind set to "hyperliquid_positions_all_dex_report", requested_dexes, per_dex, totals, totals_policy, and warnings. Do not expect requested_dexes, per_dex, or totals in regular status output.

Preview Deposit Diagnostics

For deposit questions, use a dry-run. This checks the planned Arbitrum USDC bridge path without requesting a signature or submitting a transaction.

bullpen hl deposit --amount 10 --dry-run --output json

This is a preview only. Remove --dry-run and add --yes only after the source address, bridge contract, amount, and balance check are acceptable. Live deposit moves real funds.

Inspect Agent Slot Pressure

For agent-wallet slot pressure, list agents before approving or revoking anything.

bullpen hl agent list --all-wallets --output json

This read-only command reports current unnamed and named agent slot usage. It does not create, rotate, approve, revoke, or consume agent/API-wallet slots.

References

Use the generated references for exact options: status, balances, orders, perp-dexes, deposit, and agent list.

For trade planning, money movement, agent management, and release-boundary context, return to Perps (Hyperliquid).