Get Order History

This endpoint allows you to retrieve the order history for a specified time range. You can filter the results based on various parameters such as status, matching status, and external user ID.

HTTP Request

GET /api/v1/orders

Headers

Authorization: Bearer Token (required)

Query Parameters

from: Unix timestamp for the start of the time range (required)
to: Unix timestamp for the end of the time range (required)
status: Filter by order status (e.g., open, settled, manually_settled, closed, void)
matching_status: Filter by matching status (e.g., partially_matched, unmatched, fully_matched)
external_user_id: Filter by external user ID
cursor: Pagination cursor
limit: Number of records to return (default 20, max 100)

Responses

200 OK: Returns the order history data
400 Bad Request: Invalid request parameters
401 Unauthorized: Invalid or missing authentication token
500 Internal Server Error: Server encountered an error

Example Request

GET /api/v1/orders?from=1609459200&to=1612137600&status=open HTTP/1.1
Host: api.example.com
Authorization: Bearer YOUR_TOKEN

Example Response

{
  "success": true,
  "data": {
    "orders": [
      {
        "order_id": "12345",
        "status": "open",
        "created_at": "2021-01-01T00:00:00Z",
        "updated_at": "2021-01-02T00:00:00Z",
        "external_user_id": "user_123",
        "stake": 100.0,
        "profit": 50.0
      }
    ],
    "pagination": {
      "has_next_page": false,
      "limit": 20,
      "next_cursor": null
    }
  }
}

This endpoint is useful for tracking and managing order histories, providing detailed insights into order statuses and user activities.