Place order

Place a new order. The user is resolved by the provided API key.

Note

To use this feature, you need an API key generated in the Revolut X web app. Please join the waitlist to get access.

Request​

Order placement details.

Request body

Body object

Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

Unique identifier for idempotency.

Example: "BTC-USD"

The trading pair symbol.

Possible values: [buy, sell]
Example: "buy"

The direction of the order.

Configuration for the order. Must contain exactly one of 'limit' or 'market'.

Limit order configuration. Must contain exactly one of 'base_size' or 'quote_size'.

Example: "0.1"

Amount of base currency.

Example: "0.1"

Amount of quote currency.

Example: "50000.50"

The limit price.

Possible values: [allow_taker, post_only]
Example: ["post_only"]

Default value: allow_taker

List of execution instructions for the order.

Market order configuration. Must contain exactly one of 'base_size' or 'quote_size'.

Example: "0.1"

Amount of base currency.

Example: "0.1"

Amount of quote currency.

Response​

OK

The successfully placed order details.

Response body

Body object

Wrapper object containing the order details.

ID of the order generated by the system.

Client order ID provided by the client.

Possible values: [pending_new, new, partially_filled, filled, cancelled, rejected, replaced]

Order state after submitting it.