# Revolut X Orders

> Revolut X order management — place market or limit orders, view active and historical orders, and cancel orders. Use when the user asks to buy or sell crypto, place a market or limit order, check open orders, cancel an order, or anything related to trading on Revolut X.

- Skill: `revolut-engineering/revolut-x-orders` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add revolut-engineering/revolut-x-orders`
- Raw SKILL.md: https://api.skillmd.com/api/skills/revolut-engineering/revolut-x-orders/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: revolut-engineering (https://skillmd.com/u/revolut-engineering)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/revolut-engineering/revolut-x-orders

---


# Revolut X Orders

## Capabilities

- Place market orders (buy/sell by base or quote size)
- Place limit orders (with `allow_taker` or `post_only` execution)
- View active and historical orders
- Cancel individual orders or all open orders
- Pre-flight validation (pair constraints + balance check)

## Authentication & setup

All endpoints require authentication. See [revolut-x-auth](../revolut-x-auth/SKILL.md) for setup.

## API versioning

All endpoints use path-based versioning: `/api/1.0/`. The version is included in every request path.

## Common workflows

### Place a market order

```bash
python scripts/revx_sign.py POST /api/1.0/orders --body '{"client_order_id":"<uuid>","symbol":"BTC-USD","side":"buy","order_configuration":{"market":{"quote_size":"500"}}}'
```

### Place a limit order

```bash
python scripts/revx_sign.py POST /api/1.0/orders --body '{"client_order_id":"<uuid>","symbol":"BTC-USD","side":"buy","order_configuration":{"limit":{"price":"95000","base_size":"0.001","execution_instructions":["allow_taker"]}}}'
```

Execution instructions: `allow_taker` (default) or `post_only` (maker only — cancelled if would execute immediately).

### Get active orders

```bash
python scripts/revx_sign.py GET /api/1.0/orders/active
```

With filters:

```bash
python scripts/revx_sign.py GET /api/1.0/orders/active --query '?symbols=BTC-USD&side=buy'
```

### Get historical orders

```bash
python scripts/revx_sign.py GET /api/1.0/orders/historical --query '?start_date=START_MS&end_date=END_MS'
```

Max date range: 30 days.

### Get order by ID

```bash
python scripts/revx_sign.py GET /api/1.0/orders/ORDER_UUID
```

### Cancel an order

```bash
python scripts/revx_sign.py DELETE /api/1.0/orders/ORDER_UUID
```

### Cancel ALL orders

```bash
python scripts/revx_sign.py DELETE /api/1.0/orders
```

**Warning:** Cancels every open limit, conditional, and TPSL order.

### Pre-flight validation

Before placing any order:
1. Check pair is active and get constraints: `python scripts/revx_sign.py GET /api/1.0/configuration/pairs` (see `revolut-x-configuration`)
2. Check sufficient balance: `python scripts/revx_sign.py GET /api/1.0/balances` (see `revolut-x-balance`)
3. Verify order size meets min/max constraints

### Example 1: Place a market buy
User says: "Buy $500 worth of BTC at market price"

Actions:
1. Check pair constraints: `python scripts/revx_sign.py GET /api/1.0/configuration/pairs`
2. Check USD balance: `python scripts/revx_sign.py GET /api/1.0/balances`
3. Present confirmation summary and wait for approval
4. Generate UUID for `client_order_id`
5. Run `python scripts/revx_sign.py POST /api/1.0/orders --body '{"client_order_id":"GENERATED_UUID","symbol":"BTC-USD","side":"buy","order_configuration":{"market":{"quote_size":"500"}}}'`

Result: Order placed, `venue_order_id` returned.

### Example 2: Place a post-only limit sell
User says: "Sell 0.1 ETH at $3,500, maker only"

Actions:
1. Validate pair and balance
2. Present confirmation summary
3. Run `python scripts/revx_sign.py POST /api/1.0/orders --body '{"client_order_id":"<uuid>","symbol":"ETH-USD","side":"sell","order_configuration":{"limit":{"price":"3500","base_size":"0.1","execution_instructions":["post_only"]}}}'`

Result: Post-only limit order placed.

### Example 3: Cancel a specific order
User says: "Cancel order abc-123"

Actions:
1. Present cancellation confirmation
2. Run `python scripts/revx_sign.py DELETE /api/1.0/orders/abc-123`

Result: Order cancelled.

### Example 4: Review and cancel all open orders
User says: "Cancel all my orders"

Actions:
1. Run `python scripts/revx_sign.py GET /api/1.0/orders/active` to show current orders
2. Present the list and warn: "This will cancel ALL open orders"
3. After confirmation: `python scripts/revx_sign.py DELETE /api/1.0/orders`

Result: All open orders cancelled.

## Error handling

**Error: 400 Bad Request**
Cause: Invalid params, insufficient funds, or order rejected
Solution: Check pair constraints, verify balance, review order parameters.

**Error: 404 Not Found**
Cause: Invalid `venue_order_id`
Solution: Verify the order ID from active orders or placement response.

**Error: 429 Rate Limit**
Cause: Too many requests (or 1000 limit orders/day exceeded)
Solution: Wait for `Retry-After` header duration, then retry.

## Important notes

- **NEVER place or cancel orders without explicit user confirmation.** These operations move real money. Before executing, present a confirmation summary and wait for approval. Execute only after the user explicitly approves.
- For cancel-all (`DELETE /api/1.0/orders`), warn that this cancels **every** open order.
- Required parameters for every order: **symbol**, **side**, **size** (base_size or quote_size), **order type** (market or limit). If any are missing, ask — never guess.
- **Limit order rate limit:** 1000 placements per day
- `client_order_id` is for idempotency — use a unique UUID for each order
- Market orders: specify `base_size` OR `quote_size`, not both
- Symbols use **dash format** (`BTC-USD`) in requests

## References

- [schemas.md](references/schemas.md) — Full request/response schemas, order statuses, time-in-force values, and query filters
- [Revolut X REST API docs](https://developer.revolut.com/docs/x-api/revolut-x-crypto-exchange-rest-api)
- [Place order](https://developer.revolut.com/docs/x-api/place-order) · [Get active orders](https://developer.revolut.com/docs/x-api/get-active-orders) · [Get historical orders](https://developer.revolut.com/docs/x-api/get-historical-orders)
- [Get order](https://developer.revolut.com/docs/x-api/get-order) · [Cancel order](https://developer.revolut.com/docs/x-api/cancel-order) · [Cancel all orders](https://developer.revolut.com/docs/x-api/cancel-all-orders)

## Related skills

| Skill | Purpose |
|---|---|
| `revolut-x-auth` | API key setup and request signing |
| `revolut-x-balance` | Check available funds before placing orders |
| `revolut-x-configuration` | Validate pair constraints (min/max size, step) |
| `revolut-x-trades` | View fills and execution details after orders execute |
| `revolut-x-market-data` | Check current prices before placing orders |