On this page

# 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()

Previous Get open orders
Next Get order history by ID

Last updated 3 months ago