Skip to main content

​
Hyperliquid

Shanone’s Hyperliquid integration gives your agent 34 tools for the Hyperliquid perpetual DEX — account/portfolio state, market data (orderbooks, candles, funding), order management, leverage, and TWAP orders.

​
Getting Started

1

Get your wallet address

Copy the Ethereum wallet address you use (or plan to use) on Hyperliquid.
2

Add it to Shanone

Open Integrations in the Shanone dashboard, select Hyperliquid, and enter your wallet address. This is enough for all read-only account and market data tools.
3

Configure a private key for trading (optional)

Placing or modifying orders requires a private key, which is configured separately as an environment variable rather than through the standard integration form — check with your Shanone admin if trading tools return an authentication error.

​
Available Tools

Shanone provides 34 tools for Hyperliquid, organized into these categories:
hyperliquid_get_account_state, hyperliquid_get_spot_balances, hyperliquid_get_portfolio, hyperliquid_get_subaccounts
hyperliquid_get_all_mids, hyperliquid_get_orderbook, hyperliquid_get_recent_trades, hyperliquid_get_candles
hyperliquid_get_perp_meta, hyperliquid_get_spot_meta, hyperliquid_get_asset_contexts
hyperliquid_get_fills, hyperliquid_get_fills_by_time, hyperliquid_get_funding_history, hyperliquid_get_user_fees, hyperliquid_get_rate_limit
hyperliquid_get_funding_rates, hyperliquid_get_funding_rate_history, hyperliquid_get_predicted_fundings
hyperliquid_get_open_orders, hyperliquid_get_order_status, hyperliquid_get_order_history, hyperliquid_place_order, hyperliquid_cancel_order, hyperliquid_cancel_orders_by_coin, hyperliquid_modify_order, hyperliquid_cancel_all_orders
hyperliquid_place_twap_order, hyperliquid_cancel_twap_order
hyperliquid_update_leverage, hyperliquid_update_isolated_margin, hyperliquid_close_position, hyperliquid_set_dead_mans_switch, hyperliquid_approve_api_wallet

​
Common Use Cases

Portfolio monitoring

Check account state, spot balances, and open positions across subaccounts

Market snapshotting

Pull orderbook depth, recent trades, and candles for a coin before making a decision

Automated order management

Place, modify, or cancel orders programmatically, including TWAP execution

Risk management

Adjust leverage/margin mode and configure a dead man’s switch to auto-cancel orders if the agent goes silent

​
Troubleshooting

Read-only tools work with just a wallet address, but placing/modifying/canceling orders requires a private key configured server-side — confirm with your admin that trading is enabled for your account.
Confirm you’re checking the right subaccount with hyperliquid_get_subaccounts — perp and spot balances are tracked separately (hyperliquid_get_account_state vs hyperliquid_get_spot_balances), and it’s easy to check the wrong one.
TWAP orders execute over a specified duration in slices rather than immediately — use hyperliquid_get_order_status to track progress instead of expecting an instant fill, and hyperliquid_cancel_twap_order to stop it early if needed.