Modifying Orders

Modify existing orders in-place without cancelling and re-placing

Modify existing orders in-place without cancelling and re-placing them. The registered provider plugin authorizes each modification with its SDK-managed credential; the user’s wallet is not prompted.

The examples on this page use Hyperliquid (provider: 'hyperliquid'). Replace the provider value with any supported provider from getProviders().

​

modifyOrders

const result = await perps.modifyOrders({
  provider: 'hyperliquid',
  address: userAddress,
  modifications: [
    { id: '12345678', price: '94500.00', size: '0.2' },
  ],
});

console.log(result.results);
// [{ action: 'modifyOrder', status: 'submitted' }]

A venue refusal does not throw; check status on each entry of result.results. See Execution reports and Error Handling.

Pass multiple ModifyOrderInput entries to modify several orders in one call.

​

ModifyOrderInput fields

Field	Type	Required	Description
id	string	Yes	Order ID to modify
type	OrderType.MARKET | OrderType.LIMIT	No	The new execution kind of a trigger order. Hyperliquid applies it. Without type, the modify keeps the kind of the existing order. Lighter rejects type with a 400. See provider trigger order settings.
price	string	No	New limit price of a regular order
size	string	No	New order size
triggerPrice	string	No	New trigger price (for trigger orders)
limitPrice	string	No	The new price limit of the execution of a trigger order. For LIMIT, it is the resting limit price. For MARKET, it is the slippage-adjusted limit price, on providers that take one.

Support differs per provider:

Provider	Supported fields
Hyperliquid	Limit orders: price and size. Trigger orders: type, triggerPrice, and limitPrice (size is ignored). A MARKET result takes no limitPrice. A change from MARKET to LIMIT requires limitPrice
Lighter	size is required for each modification, with price for a regular order or limitPrice for a trigger order, not both. triggerPrice is optional. type is rejected
Ondo	No modifyOrder action. Cancel and re-place instead

On Hyperliquid, the venue can leave a trigger order’s stored trigger price empty. Modifying such an order requires triggerPrice in the same call; the backend rejects the request with ValidationError otherwise.

API Reference: POST /createAction · /executeAction