Edit Order - Pacifica

The Pacifica Python SDK provides a comprehensive example on using this endpoint.

Request

{
  "id": "660065de-8f32-46ad-ba1e-83c93d3e3966",
  "params": {
    "edit_order": {
      "account": "AwX6321...",
      "signature": "5vnYpt...",
      "timestamp": 1749223025396,
      "expiry_window": 5000,
      "symbol": "BTC",
      "price": "99500",
      "amount": "0.002",
      "order_id": 645953
    }
  }
}

Field	Type	Need	Description	Example
`”id”`	Full UUID string	required	Client-defined request ID	`660065de-8f32-46ad-ba1e-83c93d3e3966`
`”params”`	object	required	Contains action type and action parameters	`”edit_order"`
`"edit_order”`	object	required	Specifies action type and contains parameters	See examples.
`”account”`	string	required	User’s wallet address	`42trU9A5…`
`“agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`
`“signature”`	string	required	Cryptographic signature	`5j1Vy9Uq…`
`“timestamp”`	integer	required	Current timestamp in milliseconds	`1716200000000`
`”expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`
`”symbol”`	string	required	Trading pair symbol	`BTC`
`”price”`	string	required	Order price	`99500`
`”amount”`	string	optional	Order amount (if omitted, only the price is changed)	`0.002`
`”order_id”`	integer	optional	System-defined order ID (needed if no CLOID provided)	`645953`
`”client_order_id”`	Full UUID string	optional	Client-defined order ID (needed if no OID provided)	`f47ac10b-58cc-4372-a567-0e02b2c3d479`
`”order_expiry”`	integer or null	optional	New expiry in milliseconds since epoch, 5 minutes to 30 days from now. Omit it to keep the current expiry. Send `null` to remove the expiry. The value, including `null`, is part of the signed data	`1716203600000`

Response

{
  "code": 200,
  "data": {
    "I": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "i": 645954,
    "s": "BTC"
  },
  "id": "660065de-8f32-46ad-ba1e-83c93d3e3966",
  "t": 1749223026150,
  "type": "edit_order",
  "rl": {
    "r": 9990,
    "q": 10000,
    "t": 1000
  }
}

Field	Type	Description
`'code'`	integer	Status code
`'data'`	object	Contains information about placed order
`'I'`	string	CLOID (if original order contained one)
`'i'`	integer	New order ID
`'s'`	string	Symbol
`'id'`	string	Client-defined request ID
`'t'`	integer	Timestamp in milliseconds
`'type'`	string	Specifies action type
`'rl'`	object or null	Rate-limit info, always present: `r` = credits remaining, `q` = quota, `t` = reset-in (ms)

On error, the frame omits data and instead carries an err (string) field describing the failure, alongside the same id, type, code, t, and rl fields. Notes: Editing an order cancels the original and creates a new one. The new order maintains the same side, reduce-only status, and client_order_id (if provided), is created with TIF = ALO (Post Only), and receives a new system-assigned order_id.

Edit orders are not subject to the taker speedbump. Because the replacement order is always created with TIF = ALO (Post Only), it can never take liquidity, so no delay is applied.

​Request

​Response

Request

Response