Get Order History Records

GET /api/v1/orders/history/records

This endpoint returns your orders and your finished order strategies in one list. It sorts the list by creation time, newest first. Each item has a kind and a record. It differs from Get order history in these ways:

It includes finished order strategies as "kind": "strategy" records. Open strategies are not included.
It leaves out orders that a strategy placed. A strategy sets parent_id on each order that it places. You can find these orders in the strategy record’s owned_orders.
It sorts by creation time. Get order history sorts by order ID.
has_more is true only when another page exists.

Query Parameters

Field	Type	Need	Description	Example
`”account”`	string	required	Account address	`42trU9A5…`
`“limit”`	integer	optional	Maximum number of records to return. Default and maximum are 100. Values outside 1 to 100 are clamped to that range	`100`
`”cursor”`	string	optional	The `“next_cursor”` value from the previous page. Leave it out to get the first page	`pxinAJf8…`

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

Response

Status 200: Successfully retrieved order history records

{
  "success": true,
  "data": [
    {
      "kind": "strategy",
      "record": {
        "strategy_id": "0f8e6c2a-5b1d-4c3e-9a7f-2d4b6e8a1c3f",
        "revision": 2,
        "account": "42trU9A5...",
        "strategy_type": "twap",
        "definition": {
          "strategy_type": "twap",
          "params": { ... }
        },
        "lifecycle": "completed",
        "state": { ... },
        "applied_trade_history_id": 912800455,
        "applied_order_history_id": 1840022917,
        "expires_at_ms": null,
        "scheduled_start_at_ms": null,
        "scheduled_end_at_ms": null,
        "created_at_ms": 1759224900000,
        "updated_at_ms": 1759225500000,
        "owned_orders": [
          {
            "order_id": 315992800,
            "prev_order_id": null,
            "is_open": false,
            "client_order_id": null,
            "take_profit_client_order_id": null,
            "stop_loss_client_order_id": null
          },
          ...
        ]
      }
    },
    {
      "kind": "order",
      "record": {
        "order_id": 315992721,
        "client_order_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "parent_id": null,
        "symbol": "XPL",
        "side": "ask",
        "initial_price": "1.0865",
        "average_filled_price": "0",
        "amount": "984",
        "filled_amount": "0",
        "order_status": "open",
        "order_type": "limit",
        "stop_price": null,
        "stop_parent_order_id": null,
        "reduce_only": false,
        "trigger_price_type": null,
        "reason": null,
        "instrument_type": "perpetual",
        "created_at": 1759224893638,
        "updated_at": 1759224893638
      }
    },
    ...
  ],
  "next_cursor": "pxinAJf8...",
  "has_more": true
}

Field	Type	Description
`”kind”`	string	`”order”` or `“strategy"`
`"record”`	object	An order record or a strategy record, as set by `“kind”` (see below)
`“next_cursor”`	string	Cursor for the next page. Omitted when `“has_more”` is `false`
`”has_more”`	boolean	`true` if more records exist after this page

To get the next page, send the same request with cursor set to next_cursor. Treat the cursor as an opaque string. It doesn’t work with Get order history. Order Record Fields ("kind": "order") Each order appears once, in its latest state.

Field	Type	Description
`”order_id”`	integer	Order id assigned to order
`”client_order_id”`	UUID	CLOID of order if assigned by user
`”parent_id”`	UUID or null	Always `null` in this endpoint
`”symbol”`	string	Trading pair symbol
`”side”`	string	Whether the order is a bid or an ask
`”initial_price”`	decimal string	Initial (limit) price of the order
`”average_filled_price”`	decimal string	VWAP of price at which the order was filled. `“0”` if nothing has filled
`”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 of a stop order
`”stop_parent_order_id”`	integer	Parent order id of a stop order
`”reduce_only”`	boolean	If the order is reduce only
`”trigger_price_type”`	string	Price type used to trigger stop orders (`mark_price`, `last_trade_price`, `mid_price`); defaults to `last_trade_price`
`”reason”`	string	Provides reason for an order being `“cancelled”` or `“rejected”`: `“cancel"` `"force_cancel"` `"expired"` `"post_only_rejected"` `"self_trade_prevented"`
`"instrument_type”`	string	`”perpetual”` or `“spot"`
`"created_at”`	integer	Timestamp in milliseconds of the first event for this order. The list sorts by this value
`”updated_at”`	integer	Timestamp in milliseconds of the latest event for this order

Strategy Record Fields ("kind": "strategy") A strategy record is a finished order strategy. The main fields are below. See Order strategies for the full shape, definition, and state.

Field	Type	Description
`”strategy_id”`	UUID	Strategy ID
`”strategy_type”`	string	Strategy type, for example `“twap"`
`"lifecycle”`	string	`”completed"` `"cancelled"` `"expired"` `"failed"`
`"terminal_reason”`	string	Why the strategy ended, for example `“user_cancel”` or `“insufficient_balance”`. Omitted when no reason applies
`”owned_orders”`	array	Orders that the strategy placed
`”created_at_ms”`	integer	Timestamp in milliseconds when the strategy was created. The list sorts by this value
`”updated_at_ms”`	integer	Timestamp in milliseconds when the strategy last changed

Status 400: Invalid request parameters or invalid cursor
Status 500: Internal server error

Code Example (Python)

import requests

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

data = response.json()

​Query Parameters

​Response

​Code Example (Python)

Query Parameters

Response

Code Example (Python)