Skip to main content
GET
/
partner
/
exchange
/
orders
List orders
curl --request GET \
  --url https://api.stabyl.com/v1/partner/exchange/orders \
  --header 'X-Api-Key: <api-key>'
{
  "data": {
    "next_cursor": null,
    "orders": []
  },
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://stabyl.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

Order list

​
data
object
required

Paginated collection of orders for the authenticated account.

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