# Revx Market

> Revolut X market data commands. Use when the user asks to "check crypto prices", "view candles", "get ticker", "see order book", "list currencies", "list trading pairs", or runs revx market commands.

- Skill: `revolut-engineering/revx-market` (Agent Skill)
- Install (CLI): `npx skillmds@latest add revolut-engineering/revx-market`
- Raw SKILL.md: https://api.skillmd.com/api/skills/revolut-engineering/revx-market/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: revolut-engineering (https://skillmd.com/u/revolut-engineering)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/revolut-engineering/revx-market

---


# Market Data (`revx market`)

> Query currencies, trading pairs, live prices, historical candles, and order book depth.

> **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`. Use `revx market pairs` to see all valid pairs.

---

## Currencies & Pairs

```bash
revx market currencies                 # All currencies (symbol, name, type, scale, status)
revx market currencies fiat            # Fiat currencies only
revx market currencies crypto          # Crypto currencies only
revx market currencies --filter BTC,ETH  # Filter by specific symbols
revx market pairs                      # All pairs (base, quote, min/max size, status)
revx market pairs --filter BTC-USD,ETH-USD  # Filter by specific pairs
```

---

## Tickers

```bash
revx market tickers                    # All tickers (bid, ask, mid, last, 24h stats)
revx market tickers --symbols BTC-USD,ETH-USD
revx market tickers BTC-USD            # Single ticker (key-value display)
```

---

## Candles

```bash
revx market candles BTC-USD                              # Default: 1h interval
revx market candles BTC-USD --interval 5m                # 5-minute candles
revx market candles BTC-USD --since 7d --until today     # Last 7 days
revx market candles BTC-USD --since 2025-04-14           # Since specific ISO date
revx market candles BTC-USD --since 5m --interval 1m     # Last 5 minutes, 1m candles
revx market candles ETH-USD --interval 4h --since 30d
```

**Intervals:** `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1d`, `2d`, `4d`, `1w`, `2w`, `4w` (or raw minutes)

**Time formats:** Relative (`7d`, `1w`, `4h`, `30m`, `5m`, `today`, `yesterday`), ISO date (`2025-04-14`), Unix epoch ms

**Default behavior:** When `--since` and `--until` are omitted, fetches the maximum available history for the given interval (up to 50,000 candles).

---

## Order Book

```bash
revx market orderbook BTC-USD           # 50 levels per side (default)
revx market orderbook BTC-USD --limit 20
revx market orderbook BTC-USD --limit 192   # Deepest book available
```

Depth: 1–192 levels per side.

> **Note on defaults:** The Revolut X REST API returns 20 levels by default and accepts up to 192 per call. `revx` requests 50 by default so pass `--limit 192` when you need the full book. Values outside 1–192 are rejected with an error rather than silently reduced.

---

## Related Skills

| Skill | Purpose |
|---|---|
| `revx-trading` | Act on market data — place orders |
| `revx-monitor` | Set alerts based on prices and indicators |
| `revx-account` | Check balances before trading |
| `revx-auth` | API key setup and configuration |