Revolut Trading Skill

This skill provides tools and documentation for interacting with the Revolut X Crypto Exchange API.

Capabilities

• Authentication: Securely authenticate using Ed25519 key pairs.

• Market Data: Fetch real-time market data including order books, trades, and candles.

• Trading: Place, cancel, and manage orders.

• Account Management: Retrieve account balances and transaction history.

Quick Start

1. Authentication

To use the API, you need an API Key and a private key. See 00_api_overview_and_authentication.md for details on generating keys.

2. Using the Python Client

A Python client wrapper is provided in scripts/revolut_client.py . This script handles authentication and request signing for you.

Example Usage:

from scripts.revolut_client import RevolutClient

Initialize the client

client = RevolutClient( private_key_path="path/to/private_key.pem", api_key="your_api_key" )

Get all currencies

currencies = client.get_currencies() print(currencies)

Get account balances

balances = client.get_balances() print(balances)

Place a limit order

order = client.place_order( client_order_id="unique_id_123", symbol="BTC-USD", side="buy", order_configuration={ "limit": { "price": "50000", "base_size": "0.001" } } ) print(order)

API Reference

For detailed API documentation, refer to the following files:

General

• Overview & Authentication

Market Data

• Get All Currencies

• Get All Currency Pairs

• Get Order Book

• Get Last Trades

• Get Historical OHLCV Candles

• Get All Tickers

• Get All Public Trades

Account & Trading

• Get All Balances

• Place Order

• Get Active Orders

• Get Historical Orders

• Get Order By ID

• Cancel Order By ID

• Get Fills of Order By ID

• Get Client Trades

Common Workflows

Fetching Market Data

To analyze the market before trading, use the Market Data endpoints.

• Use Get All Tickers for a quick overview of prices.

• Use Get Order Book to see depth and liquidity.

• Use Get Historical OHLCV Candles for technical analysis.

Placing an Order

• Check Balance: Ensure you have sufficient funds using Get All Balances .

• Determine Price: Use Market Data endpoints to decide on a price.

• Place Order: Use Place Order with a unique client_order_id .

• Monitor Order: Use Get Order By ID or Get Active Orders to track status.

Error Handling

The API returns standard HTTP status codes.

• 400 Bad Request : Check your parameters.

• 401 Unauthorized : Check your API key and signature.

• 429 Too Many Requests : You are being rate-limited. Back off and retry.