Available Actions

Trading actions and available markets on Hyperliquid

The Hyperliquid provider exposes trading operations in the actions array from GET /providers. Each action lists which signers can execute it.

For account setup actions (prepareAccountActions), see Prerequisites. For full parameter schemas, see the Actions API reference.

actions

These are returned in the actions array and are used for ongoing trading operations after account setup is complete.

placeOrder

Places a new order — market, limit, or with attached take-profit/stop-loss triggers. If the requested leverage differs from the current setting, the backend automatically prepends an updateLeverage action step.

Signers	USER, AGENT
Params	PlaceOrderParams — { asset, side, type?, size, price?, leverage?, reduceOnly?, timeInForce?, expiresAt?, takeProfit?, stopLoss? }
SDK methods	placeOrder() (USER_AGENT), buildOrder() + submitSignedOrder() (USER)

placeTriggerOrder

Places standalone take-profit and/or stop-loss triggers on an existing position, independent of a new order. The trigger size is determined by the current position.

Signers	USER, AGENT
Params	PlaceTriggerOrderParams — { asset, side, takeProfit?, stopLoss? }
SDK methods	placeTriggerOrder() (USER_AGENT), buildTriggerOrder() (USER)

cancelOrder

Cancels one or more open orders or trigger orders by ID.

Signers	USER, AGENT
Params	CancelOrderParams — { ids }
SDK methods	cancelOrders() (USER_AGENT), buildCancelOrder() (USER)

modifyOrder

Modifies existing orders in-place — change price, size, or trigger parameters without cancelling and re-placing.

Signers	USER, AGENT
Params	ModifyOrderParams — { modifications: [{ id, price?, size?, triggerPrice?, limitPrice? }] }
SDK methods	modifyOrders() (USER_AGENT), buildModifyOrder() (USER)

updateLeverage

Changes the leverage setting for an asset. This affects new orders and existing positions on that asset.

Signers	USER, AGENT
Params	UpdateLeverageParams — { asset, leverage }
Note	Usually generated automatically by placeOrder when the requested leverage differs from current

updatePositionMargin

Adds or removes margin on an isolated position. Use this to adjust liquidation price without changing the position size.

Signers	USER, AGENT
Params	UpdatePositionMarginParams — { asset, action: 'add' | 'remove', amount }
SDK methods	updatePositionMargin() (USER_AGENT), buildPositionMargin() (USER)

withdrawal

Withdraws USDC from the Hyperliquid account to an Arbitrum address via the Hyperliquid L1 -> Arbitrum bridge. Processing typically takes 3-4 minutes. Under unifiedAccount mode, funds are drawn from the spot USDC balance.

Signers	USER (agents cannot initiate withdrawals)
Params	WithdrawalParams — { destination, amount }
SDK methods	buildWithdrawal() + submitWithdrawal()

sendAsset

Transfers collateral between Hyperliquid sub-exchanges (HIP-3 providers). For example, moving USDC from the default venue to the xyz venue, or between any two markets within the provider.

Signers	USER (agents cannot transfer assets)
Params	SendAssetParams — { collateral, sourceDex, destinationDex, amount }
Note	Under unifiedAccount mode, like-for-like quote assets are already shared — this is primarily useful for transfers between markets with different quote assets

markets

The markets array on the provider lists all sub-markets. Each market’s id is used as the market field in AssetIdentity:

Market ID	Quote Asset	Description
hyperliquid	USDC	Default perpetuals venue
xyz	USDC	HIP-3 perpetuals
flx	USDH	HIP-3 perpetuals (USDH-quoted)
vntl	USDH	HIP-3 perpetuals (USDH-quoted)
hyna	USDE	HIP-3 perpetuals (USDE-quoted)
km	USDH	HIP-3 perpetuals (USDH-quoted)
abcd	USDC	HIP-3 perpetuals
cash	USDT0	HIP-3 perpetuals (USDT0-quoted)
para	USDC	HIP-3 perpetuals
spot	—	Spot market (no quote asset)

This list changes as new HIP-3 providers launch. Always use the live GET /providers response to get the current set of markets.