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_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"
'reason'	string	Provides reason for an order being "cancelled" or "rejected": "cancel" "force_cancel" "expired" "post_only_rejected" "self_trade_prevented"

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