Skip to content
Skills Library
Programming · Tool integration

revx-api

/revx-api

Revolut X REST API reference for this project — request signing, endpoints, rate limits, and gotchas. Use whenever writing or modifying code that talks to the Revolut X API (src/main/revx/), debugging 401/400 responses, or adding new endpoint coverage.

Licence
MIT
Last repository change
08.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 08.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Revolut X REST API reference for this project — request signing, endpoints, rate limits, and gotchas. Use whenever writing or modifying code that talks to the Revolut X API (src/main/revx/), debugging 401/400 responses, or adding new endpoint coverage.

Original author description

Revolut X REST API reference for this project — request signing, endpoints, rate limits, and gotchas. Use whenever writing or modifying code that talks to the Revolut X API (src/main/revx/), debugging 401/400 responses, or adding new endpoint coverage.

How it works

  1. Signing (the part that breaks)
  2. Endpoints in use (read-only, Phase 0)
  3. Order endpoints (Phase 4+ ONLY — risk engine must exist first)
  4. Gotchas
Original SKILL.md headings · 44 lines, 346 words
SKILL.md preview
---
name: revx-api
description: Revolut X REST API reference for this project — request signing, endpoints, rate limits, and gotchas. Use whenever writing or modifying code that talks to the Revolut X API (src/main/revx/), debugging 401/400 responses, or adding new endpoint coverage.
---

# Revolut X API — project reference

Base URL: `https://revx.revolut.com/api/1.0` · Official docs: https://developer.revolut.com/docs/api/revolut-x-crypto-exchange

## Signing (the part that breaks)

Message = `timestamp + METHOD + path + query + body`, concatenated with **no separators**:

- `timestamp`: ms epoch, identical to the `X-Revx-Timestamp` header value
- `METHOD`: uppercase
- `path`: starts at `/api` — e.g. `/api/1.0/orders/active` (NOT just `/orders/active`)
- `query`: without `?`, empty string if none — must match the actual URL query byte-for-byte (param order matters)
- `body`: minified JSON, empty string for GET

Sign with Ed25519 (`crypto.sign(null, message, privateKeyPem)`), base64-encode → `X-Revx-Signature`.
Headers: `X-Revx-API-Key` (64-char alphanumeric), `X-Revx-Timestamp`, `X-Revx-Signature`.

Debugging 401: almost always a message-construction mismatch — check path prefix, query ordering vs URLSearchParams serialization, and that body string signed == body string sent.

## Endpoints in use (read-only, Phase 0)

- `GET /balances` → array of `{currency, available, reserved, staked?, total}` (strings)
- `GET /candles/{symbol}?interval=&since=&until=` → `{data: [{start, open, high, low, close, volume}]}`; interval in **minutes** (integer); no-volume candles use mid-price
- `GET /tickers?symbols=` → `{data: [{symbol, bid, ask, mid, last_price}]}`
- `GET /configuration/pairs` → per-pair `base_step`, `quote_step`, `min_order_size`, `max_order_size`, `min_order_size_quote`, `status`
- `GET /order-book/{symbol}?limit=` (auth) — deeper than `GET /public/order-book/{symbol}` (5 levels max)

## Order endpoints (Phase 4+ ONLY — risk engine must exist first)

- `POST /orders` — body: `{client_order_id: uuid, symbol, side, order_configuration: {limit: {base_size, price, execution_instructions?}} | {market: {...}}}`. **Rate limit: 1,000 limit orders/day.**
- `PUT /orders/{venue_order_id}` — replace (new venue_order_id returned)
- `DELETE /orders/{venue_order_id}` / `DELETE /orders` (cancels ALL incl. conditional + TPSL)
- `GET /orders/active`, `/orders/historical` — cursor-paginated (`metadata.next_cursor`)
- `GET /orders/fills/{venue_order_id}`, `/trades/private/{symbol}`
- Venue supports **conditional and TP/SL order types** — every live position must carry a venue-side stop (plan §7)

## Gotchas

- Symbol format is `BTC-USD` in paths, but responses may show `BTC/USD` — normalize at the client boundary
- All monetary values are strings; never parse to float for arithmetic (display-only parsing is fine)
- 429 responses exist on all endpoints — respect the client-side token-bucket limiter
- `client_order_id` is the idempotency key — generate UUID before submit, persist before the HTTP call

Versions

The database has no other skills named revx-api.

Database snapshot: 13.11.2026 · package version 231ec82815c2 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100revx-auth
    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.
  • 100revx-telegram
    Revolut X Telegram notification connector. Use when the user asks to "set up Telegram alerts", "add Telegram bot", "manage Telegram connection", "test Telegram notification", or runs revx connector telegram commands.
  • 100revolut-webhooks
    Receive and verify Revolut Merchant webhooks. Use when setting up Revolut webhook handlers, debugging Revolut-Signature verification, or handling order and payment events like ORDER_COMPLETED, ORDER_AUTHORISED, or ORDER_PAYMENT_DECLINED.
  • 100revolut-business-integration
    Integration skill for Revolut Business statement CSV exports. Activate when the user uploads a Revolut Business CSV, Revolut statement, or mentions Revolut Business transactions.
  • 96agentio-revolut
    Use when interacting with revolut via the agentio CLI.
  • 100laravel-api
    Use when creating API endpoints, transforming responses with API Resources, or handling API authentication, rate limiting, or versioning.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.