Get TWAP Order History - Pacifica

GET /api/v1/orders/twap/history

Returns one row per TWAP order, open or finished, with its latest state. Rows are sorted by order_id, newest first. This history doesn’t include TWAP order strategies. To see both kinds, use Get TWAP record history.

Query Parameters

Field	Type	Need	Description	Example
`”account”`	string	required	Account address to filter TWAP orders	`42trU9A5…`
`“limit”`	integer	optional	Maximum number of records to return, default to 100. Values above 4000 are capped at 4000	`100`
`”cursor”`	string	optional	Cursor pagination to access records. Default to none	`1115hVka`

/api/v1/orders/twap/history?account=42trU9A5...&limit=100

Response

Status 200: Successfully retrieved TWAP order history

{
  "success": true,
  "data": [
    {
      "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",
      "total_filled_value": "3496.5",
      "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,
      "expiration": 1716203630000,
      "created_at": 1716200000000,
      "updated_at": 1716201200000
    },
    ...
  ],
  "next_cursor": "1111Hyd74",
  "has_more": true
}

Field	Type	Description
`”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
`”average_price_of_last_filled_sub_order”`	decimal string	Average fill price of the latest sub-order that filled
`”value_of_last_filled_sub_order”`	decimal string	Filled value (price × amount) of the latest sub-order that filled
`”total_filled_value”`	decimal string	Total value (price × amount) filled across all sub-orders. Divide by `filled_amount` to get the average fill price
`”order_status”`	string	`”open”`: no sub-order processed yet `”in_execution”`: sending sub-orders `”completed”`: the full amount filled `”cancelled”`: cancelled, for example by a cancel request or a liquidation `”expired”`: ended with part of the amount unfilled `”rejected_due_to_sub_order”`: stopped because the engine rejected a sub-order
`”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
`”expiration”`	integer	Timestamp in milliseconds when the TWAP order’s time runs out
`”created_at”`	integer	Timestamp in milliseconds when the TWAP order was created on Pacifica
`”updated_at”`	integer	Timestamp in milliseconds of the TWAP order’s latest event
`’next_cursor’`	string	Next cursor for pagination. Omitted when `‘has_more’` is false
`’has_more’`	boolean	True if there exists a `‘next_cursor’`

Status 400: Invalid request parameters
Status 500: Internal server error

Code Example (Python)

import requests

response = requests.get(
    "/api/v1/orders/twap/history?account=42trU9A5...&limit=100",
    headers={"Accept": "*/*"},
)

data = response.json()