List Orders

curl --request GET \
  --url https://api.centosfi.com/v1/orders

{
  "orders": [
    {
      "centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "order_type": "<string>",
      "time_in_force": "<string>",
      "qty": 123,
      "buy_flag": true,
      "status": "<string>",
      "subaccount_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "complex_order_ids": {},
      "price": 123,
      "centos_id": 123,
      "custom_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "expiry_ts_utc": "2023-11-07T05:31:56Z",
      "traded_qty": 0,
      "average_price": 123,
      "fees_paid": 0,
      "reject_reason": "<string>"
    }
  ],
  "count": 123
}

Orders

List Orders

List orders with optional filters.

Returns a paginated list of orders across all accessible subaccounts, ordered by created_at descending.

Filters: All filters are optional and can be combined. If no subaccount_id is specified, returns orders from all subaccounts the user has access to.

Order Statuses:

PENDING_SUBMISSION: Order received, awaiting exchange submission.
PROCESSING: Being processed by the order consumer.
RESTING: Live on the exchange order book.
PARTIALLY_FILLED: Some quantity executed, remainder resting.
EXECUTED: Fully filled.
CANCELLED: Cancelled by user or system.
REJECTED: Rejected by exchange (see order details for reason).
EXPIRED: GTD order past expiry time.

Aggregated Fields: Each order includes traded_qty, average_price, and fees_paid computed from fills.

GET

orders

List Orders

curl --request GET \
  --url https://api.centosfi.com/v1/orders

{
  "orders": [
    {
      "centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "order_type": "<string>",
      "time_in_force": "<string>",
      "qty": 123,
      "buy_flag": true,
      "status": "<string>",
      "subaccount_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "complex_order_ids": {},
      "price": 123,
      "centos_id": 123,
      "custom_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "expiry_ts_utc": "2023-11-07T05:31:56Z",
      "traded_qty": 0,
      "average_price": 123,
      "fees_paid": 0,
      "reject_reason": "<string>"
    }
  ],
  "count": 123
}

Query Parameters

status

enum<string> | null

Filter by order status

Available options:

PENDING_SUBMISSION,

RESTING,

EXECUTED,

CANCELLED,

REJECTED,

EXPIRED,

PARTIALLY_FILLED,

PROCESSING

centos_id

integer | null

Filter by instrument ID

custom_asset_id

string<uuid> | null

Filter by custom asset ID

subaccount_id

string<uuid> | null

Filter to a specific subaccount

buy_flag

boolean | null

Filter by direction: true=buys, false=sells

limit

integer

default:100

Results per page (max 1000)

Required range: 1 <= x <= 1000

offset

integer

default:0

Pagination offset

Required range: x >= 0

Response

Successful Response

Schema for list of orders.

orders

OrderResponse · object[]

required

List of orders matching the query

Show child attributes

count

integer

required

Total count of matching orders (for pagination)

Create Order Get Order