actions array from GET /providers. Each action lists which signers can execute it.
For account setup actions (the provider’s setup array) and post-setup options (options), see Setup. 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.
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.
placeTwapOrder
Places a TWAP parent order that executes over a fixed duration via the twapOrder exchange action. randomize is the only TWAP knob exposed to callers — sub-order cadence and the slippage cap are fixed venue-side. Builder fees attach only to the builder field on a regular order; the TWAP action’s wire omits that field entirely.
durationSeconds must be a whole number of minutes (a multiple of 60) between 300 and 604800 seconds (5 minutes–7 days) — the venue’s wire only carries whole minutes. On success, ActionResult.twapId carries Hyperliquid’s numeric TWAP identifier, read from the ack’s status.running.twapId; a TWAP parent’s identity lives entirely on that twapId channel, so this action never returns an orderId.
cancelOrder
Cancels one or more open orders or trigger orders by ID.
cancelTwapOrder
Cancels a running TWAP parent by id via the twapCancel exchange action.
market is required because the cancel wire is keyed by asset id, and asset resolution for a twapId is only possible with that market context supplied by the caller; twapId is the numeric id returned from placeTwapOrder.
modifyOrder
Modifies existing orders in-place — change price, size, or trigger parameters without cancelling and re-placing.
updateLeverage
Changes the leverage setting for an asset. This affects new orders and existing positions on that asset.
updatePositionMargin
Adds or removes margin on an isolated position. Use this to adjust liquidation price without changing the position size.
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.
Withdrawals are not part of the trading actions — they require a direct user signature and are documented separately. See Withdrawals.
categories
The categories array on the provider lists all trading categories. Each category’s id is used as the categoryId field in MarketRef. The list is built dynamically from Hyperliquid’s perpDexs endpoint at request time, so it always reflects the current set of active venues — including any HIP-3 sub-dexes that have launched since this page was written.
A typical response looks like:
The set of HIP-3 sub-dexes changes as new venues launch — names and quote assets are not stable. Always read the live
GET /providers response (or getProviders() from the SDK) to discover the current set of categories and their quote assets, rather than hard-coding values from this page.