Get order history

This endpoint allows users to get a summarized order history.

GET /api/v1/orders/history

Query Parameters

Field	Type	Need	Description	Example
"account"	string	required	Account address to filter orders	42trU9A5...
"limit"	integer	optional	Maximum number of records to return default system defined limit	100
"offset"	integer	optional	Number of records to skip	0

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

Response

• Status 200: Successfully retrieved order history

  [
    {
      "order_id": 13753364,
      "client_order_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "symbol": "BTC",
      "side": "bid",
      "initial_price": "87500",
      "average_filled_price": "87340",
      "amount": "0.0053",
      "filled_amount": "0.0043",
      "order_status": "open",
      "order_type": "limit",
      "stop_price": null,
      "stop_parent_order_id": null,
      "reduce_only": false,
      "reason": null,
      "created_at": 1748956314604,
      "updated_at": 1748956324604
    }
  ]

Field	Type	Description
"order_id"	integer	Order id assigned to order
"client_order_id"	UUID	CLOID of order if assigned by user
"symbol"	string	Trading pair symbol
"side"	string	Whether the order is a bid or an ask
"price"	decimal string	Price set by the order
"initial_price"	decimal string	Amount (in token denomination) of the order placed
"average_filled_price"	decimal string	VWAP of price at which the order was filled at
"amount"	decimal string	Amount (in token denomination) of the order placed
"filled_amount"	decimal string	Amount (in token denomination) of the order placed that was filled
"order_status"	string	"open" "partially_filled" "filled" "cancelled" "rejected"
"order_type"	string	"limit" "market" "stop_limit" "stop_market" "take_profit_limit" "stop_loss_limit" "take_profit_market" "stop_loss_market"
"stop_price"	decimal string	Stop price assigned upon order creation for subsequent position if order is filled if specified by user.
"stop_parent_order_id"	integer	Order id of stop order attached to original order
"reduce_only"	boolean	If the order is reduce only
"reason"	string	Provides reason for an order being "cancelled" or "rejected": "cancel" "force_cancel" "expired" "post_only_rejected" "self_trade_prevented"
"created_at"	integer	Timestamp in milliseconds when the order was created on Pacifica
"updated_at"	integer	Timestamp in milliseconds when any of the order was last modified

• Status 400: Invalid request parameters

• Status 401: Unauthorized access

• Status 500: Internal server error

Code Example (Python)

import requests

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

data = response.json()