Get active orders
Get active crypto exchange orders for the requesting user. The user is resolved by the provided API key.
This endpoint does not return orders in other services provided by Revolut.
X-API-KEY
The API key provided to you by Revolut X. Each API key directly maps to a user account (either business or retail).
Request
Cursor that identifies the page, obtained from the previous response (metadata.nextCursor
).
Default value: 100
Maximum number of records returned in one query. If not provided, it defaults to 100.
Response
OK
The list of active orders.
ID of the order.
ID of the previous/replaced order. Present only if this order has replaced another one.
ID of the order assigned by the client when creating the order.
Symbol of the asset for which this order has been created.
Possible values: [buy
, sell
]
Side of the order. Indicates whether the order was to acquire (buy) or dispose of (sell) an asset.
Possible values: [market
, limit
]
Type of the order.
A market order is executed immediately at the current market price. A limit order is executed only if the asset reaches a specified price set by the trader.
Quantity of the order, expressed in base currency.
Quantity of the order that has been filled.
In other words, how much of the order has already been executed.
Quantity of the order that remains to be filled.
In other words, how much of the order remains to be executed.
The worst price for the client at which an order will be filled.
This is the worst price at which the user is willing to trade. For buy orders, it's the maximum price for the order; for sell orders, it's the minimum price.
Quantity-weighted average fill price of the order.
This is the average price at which the order has been executed so far. If the order is filled in parts at different prices, this indicates the overall average price for the order.
Possible values: [pending_new
, new
, partially_filled
, filled
, cancelled
, rejected
, replaced
]
Status of the order:
pending_new
: Accepted by a matching engine but not yet working.new
: Working order.partially_filled
: Partially filled order.filled
: Fully filled order.cancelled
: Cancelled order.rejected
: Rejected order.replaced
: Replaced order.
Reason for rejecting the order, present only for status=rejected
.
Possible values: [gtc
]
Time in force of the order. Indicates how long the order should remain active before it’s either executed or canceled. Possible values:
gtc
: Good till cancelled. Means that the order stays active until it’s either completely filled or it's manually cancelled by the user who created the order.
Creation timestamp of the order, returned as ISO-8601 string.