revolut-engineering/revolut-x-api/revx-trading

Trading (revx order place / revx order replace / revx order cancel)

Place market, limit, conditional (stop) and take-profit/stop-loss orders, replace (modify) open orders, cancel open orders.

Auth required. Make sure revx is installed and configured before running these commands. If any command fails with an auth-related error — Auth not configured, No private key found, Authentication failed (401), Invalid signature, insecure permissions, or a missing key/config file at ~/.config/revolut-x/ — invoke the `revx-auth` skill immediately and apply the fix yourself. Do not interrupt the user to ask them to run setup. Only escalate to the user for steps only they can perform (pasting the API key, registering the public key in their Revolut X profile). After the fix, retry the original command.

Symbols use BASE-QUOTE format with a dash: BTC-USD, ETH-EUR, SOL-USD. Check pair constraints with revx market pairs (see revx-market skill).

order place and order replace support --json or --output json for machine-readable output.

Behavioral Instructions for Claude

Human Confirmation Required

NEVER execute `revx order place`, `revx order replace`, or `revx order cancel` without explicit user confirmation. These commands move real money.

Before running any order command, present a confirmation summary to the user:

Order to place:

- Pair: BTC-USD

- Side: buy

- Type: limit @ $95,000

- Size: 0.001 BTC

Shall I proceed?

For conditional and take-profit/stop-loss orders, include the trigger details in the summary:

Order to place:

- Pair: BTC-USD

- Side: sell

- Type: conditional — triggers at $100,000, then sells 0.001 BTC at market

Shall I proceed?

Only execute after the user explicitly approves (e.g., "yes", "go ahead", "do it").

For revx order cancel --all, warn the user that this cancels every open order and confirm.

Missing Parameters — Always Ask, Never Guess

All required parameters must come from the user. If any are missing, ask for them before building the command.

Required for every order:

1. Symbol — which pair? (e.g., BTC-USD)
2. Side — buy or sell?
3. Size — how much? (--qty for base currency or --quote for quote currency; take-profit/stop-loss orders accept --qty only)
4. Order type — market (--market), limit (--limit <price>), conditional (--conditional), or take-profit/stop-loss (--tp/--sl)?

Additional requirements by order type:

• Conditional orders also need a trigger price. Optionally a trigger limit price.
• Take-profit/stop-loss orders need at least one of --tp <price> / --sl <price>. Trigger directions are derived from the side automatically — never pass them.

Never assume defaults for these parameters. If the user says "buy some BTC", ask:

• How much? (quantity in BTC or dollar amount)
• Market order or limit? (if limit, at what price?)

Optional flags (--post-only) can be omitted unless the user requests them.

Place Orders

# Market order (buy 0.001 BTC at best price)
revx order place BTC-USD buy --qty 0.001 --market
 
# Limit order (buy 0.001 BTC at $95,000 or better)
revx order place BTC-USD buy --qty 0.001 --limit 95000
 
# Post-only limit (maker only, cancelled if would take)
revx order place BTC-USD buy --qty 0.001 --limit 95000 --post-only
 
# Limit order with time in force (immediate-or-cancel)
revx order place BTC-USD buy --qty 0.001 --limit 95000 --time-in-force ioc
 
# Quote-sized order (buy $500 worth of BTC at market)
revx order place BTC-USD buy --quote 500 --market

Arguments: <symbol> <side>

• symbol: BASE-QUOTE format (e.g., BTC-USD, ETH-EUR)
• side: buy or sell (case-insensitive)

Flags:

Must specify either --qty or --quote (not both).

Reading the result: the exchange answers with the order's state, and the exit code follows it. With --json, an answered order prints the exchange's document with the same exit code and the reason for a failure on stderr. A request the exchange refuses outright prints only its error on stderr. A new order isn't listed for a few seconds, so wait before revx order get or revx order fills.

If the reply is lost: every order is sent with a client order ID, generated unless you pass --client-order-id. When the connection drops after the order may have reached the exchange, or the exchange answers with a server error, the command exits 1, says the order may have been placed and prints its client order ID on stderr. stdout stays empty, also with --json, so a script should pass its own --client-order-id (a UUID). Look for that ID in revx order open --json, or revx order history --json once it has filled, before doing anything else. A market order can take a few minutes to show up. To retry, run the same command with --client-order-id <that ID>: if the first one went through, the exchange refuses the retry as already placed, and the CLI then says an order with that ID already exists and no second one was placed. Never retry without the ID, or a second order can be placed. A connection that fails before sending, such as a refused connection or a DNS failure, says so and placed nothing. For a replace, revx order get <original id> tells whether it happened: an original still open means the replace did not happen.

Price step: a --limit or --price must be a multiple of the pair's price step (revx market pairs shows it). Otherwise the CLI refuses it before sending and names the nearest valid prices. --qty, --quote, --limit and --price must be positive numbers with at most 18 decimal places.

Conditional (Stop) Orders

Waits until the market price crosses the trigger, then places a market order (default) or a limit order (with --trigger-limit-price). Exactly one order type per command.

# Stop-market: sell 0.001 BTC when the $100,000 trigger fires
revx order place BTC-USD sell --qty 0.001 --conditional --trigger-price 100000
 
# Stop-limit: buy 0.001 BTC when the $90,000 trigger fires, then place a limit buy at $89,900
revx order place BTC-USD buy --qty 0.001 --conditional --trigger-price 90000 --trigger-limit-price 89900
 
# Quote-sized conditional (buy $500 worth of BTC at the $95,000 trigger)
revx order place BTC-USD buy --quote 500 --conditional --trigger-price 95000

Flags:

Behavior:

• --time-in-force and --post-only are limit-order flags — they are rejected with conditional orders.
• Once triggered, a market leg executes immediately (ioc); a limit leg rests as a gtc limit order.
• The order rests in revx order open with type conditional and a Trig ≥/≤ <price> condition until it triggers or is cancelled.
• Cancel with the usual revx order cancel <order-id>.

Take-Profit / Stop-Loss Orders

Places a resting order that exits a position when the market reaches the take-profit and/or stop-loss trigger. At least one of --tp/--sl is required; both can be combined. Trigger directions are derived from the side — do not pass them:

• Sell TP/SL (closing a long): take profit fires when price rises to/above --tp; stop loss fires when price falls to/below --sl.
• Buy TP/SL (closing a short): take profit fires when price falls to/below --tp; stop loss fires when price rises to/above --sl.

# Sell 0.001 BTC: take profit at $110,000, stop loss at $90,000 (both market on trigger)
revx order place BTC-USD sell --qty 0.001 --tp 110000 --sl 90000
 
# Take profit only, with a limit price for the triggered leg
revx order place BTC-USD sell --qty 0.001 --tp 110000 --tp-limit 109900
 
# Stop loss only
revx order place BTC-USD sell --qty 0.001 --sl 90000
 
# Both legs with limit prices
revx order place BTC-USD sell --qty 0.001 --tp 110000 --tp-limit 109900 --sl 90000 --sl-limit 89900

Flags:

Behavior:

• --time-in-force and --post-only are rejected with TP/SL orders.
• The order appears in revx order open with type tpsl; the Conditions column shows TP <price> / SL <price>.
• If both legs are set, the first trigger wins and the other is discarded.
• Cancel with the usual revx order cancel <order-id>.

Replace (Modify) Orders

Updates an existing open order in place. Same URL as cancel, but with PUT. Works for limit, conditional (stop), and take-profit/stop-loss orders.

# Change limit price
revx order replace <order-id> --price 96000
 
# Change quantity (amount is recalculated server-side)
revx order replace <order-id> --qty 0.002
 
# Change quote amount (qty is recalculated server-side)
revx order replace <order-id> --quote 150
 
# Explicitly allow taker execution (must be set explicitly)
revx order replace <order-id> --allow-taker
 
# Switch to post-only
revx order replace <order-id> --post-only
 
# Change time in force
revx order replace <order-id> --time-in-force ioc
 
# Combine — re-price and re-size
revx order replace <order-id> --price 96000 --qty 0.002
 
# Replace a conditional (stop) trigger — the whole trigger is replaced
revx order replace <order-id> --trigger-price 100000 --trigger-limit-price 99500
 
# Change only the trigger limit price → re-pass the whole trigger
revx order replace <order-id> --trigger-price 100000 --trigger-limit-price 99000
 
# Replace take-profit/stop-loss triggers, or re-size the order only
revx order replace <order-id> --tp 115000 --tp-limit 114900 --sl 90000
revx order replace <order-id> --qty 0.002
 
# Remove a trigger leg — pass `none` explicitly
revx order replace <order-id> --sl none