revolut-engineering/revolut-x-api/revx-account

Account, Transaction & Order Queries

View balances and transactions, query orders, browse trade history.

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, choosing a passphrase). After the fix, retry the original command.

All commands support --json or --output json for machine-readable output.

Symbols use BASE-QUOTE format with a dash: BTC-USD, ETH-EUR, SOL-USD.

Balances

revx account balances                          # Non-zero balances
revx account balances --all                    # Include zero balances
revx account balances BTC                      # Single currency (case-insensitive)
revx account balances --currencies BTC,ETH,USD # Filter by multiple currencies

Sub-Accounts

revx account sub-accounts                      # Sub-account totals converted to USD
revx account sub-accounts --convert-to EUR     # Totals converted to another currency

Lists every sub-account with its total balance (available + reserved, converted at mid-market rates to --convert-to, default USD). One row per sub-account: name, total balance, currency, created and updated times.

The converted total is informational — individual currency balances come from revx account balances. Sub-account names also appear as account.display_name on transactions (Crypto Primary is the main X balance).

Transactions

revx transaction list                              # Last 30 days
revx transaction list --start-date 7d              # Last 7 days
revx transaction list --types buy,receive          # Types: buy, sell, receive, send, stake, un_stake, reward
revx transaction list --statuses completed,pending # Filter by status
revx transaction list --currencies BTC,USD         # Filter by either side
revx transaction list --limit 100 --json           # Limit and JSON output
revx transaction get <transaction-id>               # Full details of one transaction

Filters: --start-date, --end-date, --types (buy, sell, receive, send, stake, un_stake, reward), --statuses (pending, completed, cancelled, failed, reverted), --currencies, --limit

Default: When no dates are specified, returns the last 30 days. Time formats: relative (7d, 1w, today), ISO date (2025-04-14), Unix epoch ms.

In table output, show the complete transaction UUID. The source side is Source Amount with a minus sign and the destination side is Destination Amount with a plus sign; account fields are not shown in the table. Buys and sells show both sides; sends and stakes show only Source Amount; receives, rewards, and un_stakes show only Destination Amount.

In JSON output, use source.currency with source.amount for billing and destination.currency with destination.amount for received funds. Each side is optional; at least one side is present. Each leg carries account.type (revolut, revolut_x, external_fiat, external_crypto); account names and crypto addresses only appear via revx transaction get. Processing time is processed_date.

Transaction Details

revx transaction get <transaction-id> returns one transaction with fields the list omits:

• Each leg may include fee and fee_currency, and an account object with type (revolut, revolut_x, external_fiat, external_crypto), optional display_name (Personal for the main Revolut account, Savings for savings vaults, Crypto Primary or the account name for X sub-accounts, Staking for staking destinations), and (for external crypto wallets) crypto_address
• order_id — the venue order behind a buy or sell
• crypto_transaction_hash and network — on-chain info for external crypto sends/receives
• description — free-text note when present

Fees appear on at most one leg: the leg whose currency matches fee_currency (for same-currency sends/receives it's the source). stake, un_stake, reward, and external top-ups (crypto or bank) never show fees. Receives and sends carry both sides in details — the list shows only Source Amount for sends and only Destination Amount for receives. Stakes show only Source Amount, and un_stakes and rewards only Destination Amount, in both list and details.

Optional fields appear only when present. Use this command for questions about a specific transaction's fees, counterparty account, or on-chain details.

Open Orders

revx order open
revx order open --symbols BTC-USD,ETH-USD --side buy
revx order open --order-states pending_new,new --order-types limit --limit 50
revx order open --order-types twap

Filters: --symbols, --order-states (pending_new, new, partially_filled), --order-types (limit, conditional, tpsl, twap), --side, --limit

TWAP rows show their execution type (market or limit), optional limit price, period/frequency, and completed/total slice progress.

Order History

revx order history
revx order history --symbols BTC-USD --start-date 7d --end-date today
revx order history --order-states filled,cancelled --limit 20
revx order history --order-types twap --start-date 7d

Filters: --symbols, --order-states (filled, cancelled, rejected, replaced, partially_filled), --order-types (market, limit, conditional, tpsl, twap), --start-date, --end-date, --limit

Default: When no dates are specified, returns the last 30 days. Time formats: relative (7d, 1w, today), ISO date (2025-04-14), Unix epoch ms.

Order Details & Fills

revx order get <order-id>              # Full order details
revx order fills <order-id>            # All fills for an order

Order details always include time_in_force — one of gtc, ioc, or fok (an order can come back as fok even though only gtc/ioc can be set when placing/replacing).

For market orders that are filled, partially filled, or cancelled, Price is the average execution price when one was recorded and otherwise the price recorded at submission. The output does not distinguish the two, so read Avg Fill Price when you need the realized average.

Optional fields in order details output (shown only when present):

• amount / filled_amount — quote-currency size and how much of it has been filled
• average_fill_price — volume-weighted average execution price, filled_amount / filled_quantity (shown as "Avg Fill Price"); present whenever any quantity has filled, including cancelled orders with partial fills
• total_fee / fee_currency — total fee charged and the currency it was paid in
• conditional / take_profit / stop_loss — trigger definitions on conditional and TPSL orders; each includes trigger price, direction (≥/≤), order type (market/limit), time in force, and optional limit price
• twap — schedule and progress for a TWAP parent order: child execution type (market or limit), optional limit price, period and frequency in seconds, total/completed slices, start/end times, and (for order get) any linked child order IDs
• triggered_by — present when this order was submitted by a conditional, TP/SL, or TWAP trigger; reason: twap includes the TWAP parent order ID and slice index. Mutually exclusive with on_fill.
• on_fill — present when a linked TP/SL exit strategy is attached to this order; includes take-profit / stop-loss triggers and, once the order is filled, the linked order id. Mutually exclusive with triggered_by.

For a full TWAP execution tree, run revx order get <twap-parent-id> and then inspect each linked child ID with revx order get <child-id>. Linked child IDs are available on the parent detail response, not in open-order or history lists.

Trades

revx trade private BTC-USD                                # My trade history
revx trade private BTC-USD --start-date 7d --limit 100
revx trade private BTC-USD --start-date 2025-04-01 --end-date 2025-04-14
revx trade public BTC-USD                                 # Public trades
revx trade public BTC-USD --start-date 7d --end-date today
revx trade volume                                         # My trading volume, last 30 days
revx trade volume --interval-days 7                       # My trading volume, last 7 days

Filters: --start-date, --end-date, --limit

Default: When no dates are specified, returns the last 30 days. Time formats: relative (7d, 1w, today), ISO date (2025-04-14), Unix epoch ms.

Aliases: revx trade history = private, revx trade all = public.

Trading Volume

revx trade volume returns the quote-currency volume you contributed (default USD) over the window — one row per product: spot and futures (futures is omitted without an active derivatives account). Each row carries the amount, currency, and the window's start_date/end_date (epoch ms). --interval-days accepts 1–180, default 30.

Fee tiers are keyed off this volume — check revx market fees (see revx-market skill) to see the current tier and the volume thresholds.

Permission Handling for Recurring Commands (/loop)

When using /loop to run revx commands on an interval, each iteration triggers a permission prompt. To avoid repeated approvals:

1. Determine the exact revx commands needed for each iteration (e.g., revx account balances, revx order open)
2. Run each command as a separate `Bash` tool call — do NOT chain with && or pipes. This ensures each command matches a simple permission pattern
3. Present the specific commands to the user and ask for permission to add them to the allowlist
4. Use the update-config skill to add specific permission patterns to .claude/settings.local.json, e.g.:

``bash "Bash(revx account balances*)", "Bash(revx order open*)" ` Do NOT add a blanket Bash(revx *)` — only add the exact commands the loop needs

1. Then start the /loop

Permission pattern syntax: Bash(revx account balances*) uses a glob wildcard — the trailing * allows optional flags. The pattern uses a space separator (not colon). Compound commands with && or | are split into subcommands, each checked independently.

Example flow for "every 10 min check my balance and open orders":

1. Determine needs: revx account balances and revx order open
2. Tell the user: "I'll run these two commands each iteration — can I add them to your permission allowlist?"
3. On approval, add Bash(revx account balances*) and Bash(revx order open*) via update-config
4. Start /loop 10m check balance and open orders
5. Each iteration runs two separate Bash calls — no further prompts

Common Workflows

"What's my BTC worth?"

revx account balances BTC
revx market tickers BTC-USD

"Review recent trading activity"

revx transaction list --start-date 7d
revx order history --start-date 7d
revx trade private BTC-USD --start-date 7d
revx trade volume --interval-days 7

Related Skills