List orders

Returns your account’s orders with optional market, status, and pagination filters. Use this endpoint for dashboards, backfills, and reconciliation jobs.

GET /partner/exchange/orders

List orders

cURL

curl --request GET \
  --url https://api.stabyl.com/v1/partner/exchange/orders \
  --header 'X-Api-Key: <api-key>'

200

{
  "data": {
    "next_cursor": null,
    "orders": []
  },
  "status": "success"
}

Authorizations

X-Api-Key · string · header · default: sb_test_your_key · required

API key. Send it in the X-Api-Key header.

Query Parameters

status · string | null

Optional order status filter. Supported values include pending, accepted, partially_filled, filled, cancelled, rejected, and expired.

pair_id · string | null

Trading pair identifier returned by GET /partner/exchange/markets, for example USD/NGN.

limit · integer<int64> | null

Number of orders to return for this page.

offset · integer<int64> | null

Offset for paginated order list reads.

Response

200

application/json

Order list

data · object · required

Paginated collection of orders for the authenticated account.

Show child attributes

Example:

{
  "count": 1,
  "orders": [
    {
      "avg_fill_price": "1649.50",
      "client_order_id": "cli-123",
      "created_at": "2026-01-14T10:30:00Z",
      "filled_quantity": "50.00",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "order_type": "limit",
      "pair_id": "USD/NGN",
      "price": "1650.00",
      "quantity": "100.00",
      "replace": {
        "replaced_by_order_id": null,
        "replaces_order_id": null
      },
      "side": "buy",
      "status": "accepted",
      "time_in_force": "POST_ONLY"
    }
  ]
}

status · enum<string> · required

Available options: success