Get TWAP Order History by ID - Pacifica

GET /api/v1/orders/twap/history_by_id

Returns one row per event of the TWAP order, newest first. Each row shows the order’s state after that event.

Query Parameters

Field	Type	Need	Description	Example
`”order_id”`	integer	required	TWAP order ID to retrieve history for	`13753364`

/api/v1/orders/twap/history_by_id?order_id=13753364

Response

Status 200: Successfully retrieved TWAP order history

{
  "success": true,
  "data": [
    {
      "history_id": 26698518,
      "order_id": 13753364,
      "client_order_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "symbol": "BTC",
      "side": "bid",
      "initial_amount": "0.121",
      "filled_amount": "0.04",
      "average_price_of_last_filled_sub_order": "87420",
      "value_of_last_filled_sub_order": "87.42",
      "event_type": "sub_order_executed",
      "order_status": "in_execution",
      "reduce_only": false,
      "slippage_percent": "0.500000000000",
      "planned_sub_order_amount": "0.001",
      "planned_sub_order_count": 121,
      "past_sub_order_count": 40,
      "created_at": 1716201200000
    },
    {
      "history_id": 26690012,
      "order_id": 13753364,
      "client_order_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "symbol": "BTC",
      "side": "bid",
      "initial_amount": "0.121",
      "filled_amount": "0",
      "average_price_of_last_filled_sub_order": "0",
      "value_of_last_filled_sub_order": "0",
      "event_type": "twap_created",
      "order_status": "open",
      "reduce_only": false,
      "slippage_percent": "0.500000000000",
      "planned_sub_order_amount": "0.001",
      "planned_sub_order_count": 121,
      "past_sub_order_count": 0,
      "created_at": 1716200000000
    }
  ],
  "error": null,
  "code": null
}

Field	Type	Description
`”history_id”`	integer	History ID of the event
`”order_id”`	integer	TWAP order ID
`”client_order_id”`	UUID or null	CLOID of the TWAP order if assigned by user
`”symbol”`	string	Trading pair symbol
`”side”`	string	Whether the order is a bid or an ask
`”initial_amount”`	decimal string	Total amount (in token denomination) of the TWAP order
`”filled_amount”`	decimal string	Amount (in token denomination) filled after this event
`”average_price_of_last_filled_sub_order”`	decimal string	Average fill price of the sub-order in this event. `0` if the event has no fill
`”value_of_last_filled_sub_order”`	decimal string	Filled value (price × amount) of the sub-order in this event. `0` if the event has no fill
`”event_type”`	string	`”twap_created”`: order created `”sub_order_executed”`: a sub-order was placed `”sub_order_failed”`: the engine rejected a sub-order `”cancel”`: order cancelled `”reject_sub_order_failure”`: order stopped after a rejected sub-order `”expiration”`: order expired with part of the amount unfilled `”completion”`: the full amount filled
`”order_status”`	string	`”open"` `"in_execution"` `"completed"` `"cancelled"` `"expired"` `"rejected_due_to_sub_order”` See Get TWAP order history
`”reduce_only”`	boolean	If each sub-order is reduce only
`”slippage_percent”`	decimal string	Maximum slippage for each sub-order, in percent
`”planned_sub_order_amount”`	decimal string	Planned amount (in token denomination) of each sub-order, set at creation
`”planned_sub_order_count”`	integer	Number of planned sub-orders
`”past_sub_order_count”`	integer	Number of planned sub-orders processed after this event
`”created_at”`	integer	Timestamp in milliseconds when the event occurred

Status 400: Invalid request parameters
Status 404: No history for this TWAP order ID
Status 500: Internal server error

Code Example (Python)

import requests

response = requests.get(
    "/api/v1/orders/twap/history_by_id?order_id=13753364",
    headers={"Accept": "*/*"},
)

data = response.json()