revolut-engineering/revolut-x-api/revx-auth

Claude Code and agent skill by revolut-engineering/revolut-x-api

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Revolut X CLI setup and authentication. Use when the user asks to "install revx", "set up Revolut X", "configure API keys", "generate keypair", "set passkey", "revx configure", or needs help with authentication errors.

Install

npx vskill@latest install revolut-engineering/revolut-x-api/revx-auth

SKILL.md

Auth & Account Setup (revx configure)

Install the CLI, generate API keys, and configure write-operation security.
Auto-resolve target. When invoked from another revx-* skill due to an auth error, do not bounce the user back to manual setup. Diagnose the failure against the Error Reference below, run the fix yourself (e.g. chmod 600 ~/.config/revolut-x/private.pem, revx configure generate-keypair, revx configure set --api-key <key>), then return to the calling skill and retry the original command. Only ask the user for inputs that only they can provide: the 64-character API key string, confirmation that they have registered the public key in their Revolut X profile, or approval to move an existing keypair aside.

Prerequisites

  • Node.js >= 20 (check with node -v)
  • npm (comes with Node.js)

Install

bash
npm install -g @revolut/revolut-x-cli && npm link @revolut/revolut-x-cli

After install, revx is available as a global command:

bash
revx --version                # Should print the version

Getting Started

Step 1: Configure Authentication
bash
revx configure                 # Interactive setup wizard

This will:

  1. Generate an Ed25519 keypair (private + public key)
  2. Display your public key — copy it
  3. Prompt you to register the public key at exchange.revolut.com -> Profile -> API Keys
  4. Create a new API key — tick the "Allow usage via Revolut X MCP and CLI" checkbox
  5. Prompt for the 64-character API key you receive after registration

Or do it step-by-step:

bash
revx configure generate-keypair          # Creates Ed25519 keypair
# Register public key at exchange.revolut.com -> Profile -> API Keys
# Create API key — tick "Allow usage via Revolut X MCP and CLI"
revx configure set --api-key <64-char-key>
Step 2: Verify Configuration
bash
revx configure get             # Show config status (keys redacted)
revx configure path            # Print config directory path

Config Commands

bash
revx configure                          # Interactive setup wizard
revx configure get                      # Show config status (keys redacted)
revx configure set --api-key <key>      # Set API key
revx configure generate-keypair         # Generate Ed25519 keypair
revx configure path                     # Print config directory path

Config Location

PlatformPath
macOS/Linux~/.config/revolut-x/
Windows%APPDATA%\revolut-x\
OverrideREVOLUTX_CONFIG_DIR env var

Error Reference

ErrorCauseFix
Auth not configuredMissing API key or private keyRun revx configure
The private key or config file <path> can't be read (EACCES)The file isn't readable by this userMake sure it belongs to the user, then chmod 600 <path>
<path> is not a fileA folder is in the wayAsk before moving the folder aside, then run revx configure
The private key <path> is missingThe API key is set but the key file is gonePut the user's copy back at <path> if they have one. Otherwise revx configure generate-keypair, then register the new public key and create a new API key for it
The private key <path> is empty, holds a public key, is protected by a passphrase, is in OpenSSH format, is not a valid PEM private key, or is not an Ed25519 keyThe key file is damaged or the wrong kindAsk first. Then move it to a new name that doesn't exist yet, such as mv -n <path> <path>.old-$(date +%s), run revx configure generate-keypair, register the new public key and create a new API key for it. Never delete the old file
The config file <path> is not valid JSON, is not a settings object, has an API key that is not 64 letters and digits, or has a private_key_path that is not textconfig.json was damagedrevx configure set --api-key <key> writes it again
Authentication failed (401)Invalid key or signatureRe-register public key at exchange.revolut.com
Network errorConnection/timeout failureCheck connectivity, retry

Next Steps

Once configured, explore:

  • Check your balances, transactions, and order history — see revx-account skill
  • View market prices and candles — see revx-market skill
  • Place your first order — see revx-trading skill

Related Skills

SkillPurpose
revx-marketCurrencies, pairs, tickers, candles, order book
revx-accountBalances, transaction history, order queries, trade history
revx-tradingPlace and cancel orders
revx-monitorLive price/indicator alerts
revx-telegramTelegram notification setup
revx-strategyGrid bot backtest, optimize, run

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
64
Repository forks
15
7-day trend score
21

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/revolut-engineering/revolut-x-api/revx-auth/badge)](https://verified-skill.com/skills/revolut-engineering/revolut-x-api/revx-auth)

Something wrong with this skill or its page? Tell us.