Name: revolut-x
Author: revolut-engineering

Stats

Actions

Available In

Tags

revolut-x-api

Monorepo for open-source tooling around the Revolut X crypto exchange.

Packages

Package

Description

api/

Typed HTTP client for the Revolut X REST API. Zero runtime dependencies — Node.js built-ins only.

mcp/

MCP server exposing tools for market data, account management, orders, monitoring, and grid strategy backtests. Use with Claude Desktop, Claude Code, or any MCP-compatible client.

cli/

revx command-line interface for trading, monitoring, and running grid bots from the terminal.

skills/

Claude Code skills — focused revx CLI command references (auth, market, account, trading, monitor, telegram, strategy).

Quick Start

MCP Server (Claude Desktop / Claude Code)

Build both the API and MCP packages:

git clone https://github.com/revolut-engineering/revolut-x-api.git cd revolut-x-api npm ci npm run build -w api npm run build -w mcp

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{ "mcpServers": { "revolutx": { "command": "node", "args": ["/path/to/revolut-x-api/mcp/dist/index.js"] } } }

Claude Code:

claude mcp add revolutx node /path/to/revolut-x-api/mcp/dist/index.js

Then ask Claude: "Set up my Revolut X API keys" to complete authentication.

CLI

git clone https://github.com/revolut-engineering/revolut-x-api.git cd revolut-x-api npm ci npm run build -w api npm run build -w cli npm link -w cli

# Setup revx configure # Set up API key and private key # Account revx account balances # Show non-zero balances revx account balances BTC # Get BTC balance revx account balances --currencies BTC,ETH,USD # Filter by currencies revx account balances --all # Include zero balances # Market revx market currencies # List supported currencies revx market currencies fiat # Filter fiat only revx market currencies crypto # Filter crypto only revx market pairs # List all trading pairs revx market pairs BTC-USD # Get BTC-USD pair info revx market tickers # List all tickers revx market tickers --symbols BTC-USD,ETH-USD # Filter tickers by pair revx market ticker BTC-USD # Get BTC-USD ticker revx market candles BTC-USD # Get hourly candles revx market candles BTC-USD --interval 5m # Get 5-minute candles revx market candles BTC-USD --since 7d --until today revx market orderbook BTC-USD # Get order book (top 10) revx market orderbook BTC-USD --limit 20 # Get order book (top 20) # Orders revx order place BTC-USD buy --qty 0.001 --market # Market buy (base qty) revx order place BTC-USD buy --quote 100 --market # Market buy (quote amount) revx order place BTC-USD sell --qty 0.001 --limit 95000 # Limit sell revx order place BTC-USD buy --qty 0.001 --limit 95000 --post-only revx order open # List active orders revx order open --symbols BTC-USD --side buy # Filter active orders revx order history --symbols BTC-USD # Order history for pair revx order get <order-id> # Get order details revx order fills <order-id> # Get order fills revx order cancel <order-id> # Cancel an order revx order cancel --all # Cancel all open orders # Trades revx trade private BTC-USD # Private trade history revx trade private BTC-USD --limit 100 --start-date 7d revx trade public BTC-USD # All public trades revx trade public BTC-USD --start-date 7d --limit 200

revolut-x-api

Monorepo for open-source tooling around the Revolut X crypto exchange.

Packages

Package	Description
`api/`	Typed HTTP client for the Revolut X REST API. Zero runtime dependencies — Node.js built-ins only.
`mcp/`	MCP server exposing tools for market data, account management, orders, monitoring, and grid strategy backtests. Use with Claude Desktop, Claude Code, or any MCP-compatible client.
`cli/`	`revx` command-line interface for trading, monitoring, and running grid bots from the terminal.
`skills/`	Claude Code skills — focused `revx` CLI command references (auth, market, account, trading, monitor, telegram, strategy).

Quick Start

MCP Server (Claude Desktop / Claude Code)

Build both the API and MCP packages:

git clone https://github.com/revolut-engineering/revolut-x-api.git
cd revolut-x-api
npm ci
npm run build -w api
npm run build -w mcp

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "revolutx": {
      "command": "node",
      "args": ["/path/to/revolut-x-api/mcp/dist/index.js"]
    }
  }
}

Claude Code:

claude mcp add revolutx node /path/to/revolut-x-api/mcp/dist/index.js

Then ask Claude: "Set up my Revolut X API keys" to complete authentication.

CLI

git clone https://github.com/revolut-engineering/revolut-x-api.git
cd revolut-x-api
npm ci
npm run build -w api
npm run build -w cli
npm link -w cli

# Setup
revx configure                                              # Set up API key and private key

# Account
revx account balances                                       # Show non-zero balances
revx account balances BTC                                   # Get BTC balance
revx account balances --currencies BTC,ETH,USD              # Filter by currencies
revx account balances --all                                 # Include zero balances

# Market
revx market currencies                                      # List supported currencies
revx market currencies fiat                                 # Filter fiat only
revx market currencies crypto                               # Filter crypto only
revx market pairs                                           # List all trading pairs
revx market pairs BTC-USD                                   # Get BTC-USD pair info
revx market tickers                                         # List all tickers
revx market tickers --symbols BTC-USD,ETH-USD               # Filter tickers by pair
revx market ticker BTC-USD                                  # Get BTC-USD ticker
revx market candles BTC-USD                                 # Get hourly candles
revx market candles BTC-USD --interval 5m                   # Get 5-minute candles
revx market candles BTC-USD --since 7d --until today
revx market orderbook BTC-USD                               # Get order book (top 10)
revx market orderbook BTC-USD --limit 20                    # Get order book (top 20)

# Orders
revx order place BTC-USD buy --qty 0.001 --market           # Market buy (base qty)
revx order place BTC-USD buy --quote 100 --market           # Market buy (quote amount)
revx order place BTC-USD sell --qty 0.001 --limit 95000     # Limit sell
revx order place BTC-USD buy --qty 0.001 --limit 95000 --post-only
revx order open                                             # List active orders
revx order open --symbols BTC-USD --side buy                # Filter active orders
revx order history --symbols BTC-USD                        # Order history for pair
revx order get <order-id>                                   # Get order details
revx order fills <order-id>                                 # Get order fills
revx order cancel <order-id>                                # Cancel an order
revx order cancel --all                                     # Cancel all open orders

# Trades
revx trade private BTC-USD                                  # Private trade history
revx trade private BTC-USD --limit 100 --start-date 7d
revx trade public BTC-USD                                   # All public trades
revx trade public BTC-USD --start-date 7d --limit 200

revolut-x

Popularity

What's Inside

Confidence

README

revolut-x-api

Packages

Quick Start

MCP Server (Claude Desktop / Claude Code)

CLI

Similar Plugins

cdcx-cli

coinos-skills

bingx-ai-skills

perp-cli

revolut-x-api

Packages

Quick Start

MCP Server (Claude Desktop / Claude Code)

CLI

Popularity

Health & Quality

Similar Plugins

cdcx-cli

coinos-skills

bingx-ai-skills

perp-cli

vulcan

trading212-api