Get all orders

List your current open orders. Only open or un-settled orders are returned by default. As soon as an order is no longer open and settled, it will no longer appear in the default request. Open orders may change state between the request and the response depending on market conditions.

Pending Orders

Orders with a “pending” status have fewer fields in the response.

• Pending limit orders do not have stp, time_in_force, expire_time, and post_only.
• Pending market orders have the same fields as a pending limit order minus price and size, and no market specific fields (funds, specified_funds).
• Pending stop orders have the same fields as a pending limit order and no stop specific fields (stop, stop_price).

Order Type	Does Not Have These Fields
Pending Limit Order	stp, time_in_force, expire_time, post_only
Pending Market Order	stp, time_in_force, expire_time, post_only, price, size, funds, specified_funds
Pending Stop Order	stp, time_in_force, expire_time, post_only, stop, stop_price

API Key Permissions

This endpoint requires either the “view” or “trade” permission.

To specify multiple statuses, use the status query argument multiple times: /orders?status=done&status=pending.

Order Status and Settlement

Orders which are no longer resting on the order book, are marked with the done status. There is a small window between an order being done and settled. An order is settled when all of the fills have settled and the remaining holds (if any) have been removed.

Polling

For high-volume trading it is strongly recommended that you maintain your own list of open orders and use one of the streaming market data feeds to keep it updated. You should poll the open orders endpoint once when you start trading to obtain the current state of any open orders.

executed_value is the cumulative match size * price and is only present for orders placed after 2016-05-20.

Open orders can change state between the request and the response depending on market conditions.

Pagination

This request is paginated. See Pagination for more information.

Authorizations

cb-access-key · string · header · required

cb-access-passphrase · string · header · required

cb-access-sign · string · header · required

cb-access-timestamp · string · header · required

Query Parameters

profile_id · string

Filter results by a specific profile_id

product_id · string

Filter results by a specific product_id

sortedBy · enum<string> · default: created_at

Sort criteria for results.

Available options:

created_at,

price,

size,

order_id,

side,

type

sorting · enum<string> · default: desc

Ascending or descending order, by sortedBy

Available options:

desc,

asc

start_date · string<date-time>

Filter results by minimum posted date

end_date · string<date-time>

Filter results by maximum posted date

before · string

Used for pagination. Sets start cursor to before date.

after · string

Used for pagination. Sets end cursor to after date.

limit · integer · default: 100 · required

Limit on number of results to return.

status · enum<string>[] · required

Array with order statuses to filter by.

Show child attributes

market_type · string · default: spot

Market type which the order was traded in.

Response

200

application/json

The response is of type object[].