# Kraken MCP

> Kraken MCP Server gives your AI client real-time access to cryptocurrency market data from the Kraken exchange. Get live prices, candlestick data, order books, and recent trades without needing API keys for public data. Analyze market depth, track 24-hour volume, and view asset details directly within your chat or IDE.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** cryptocurrency-exchange, market-data, ohlc-data, order-book, trading-pairs, real-time-price

## Description

Your AI client gives you live, real-time crypto market data straight from the Kraken exchange. You don't need to mess with API keys to get public data. You can analyze market depth, check 24-hour volume, and view asset details right inside your chat or IDE.

**`get_ticker`** lets you check the best bid/ask prices, the last trade price, 24-hour volume, VWAP, and the high/low for multiple pairs at once.

**`get_ohlc`** fetches candlestick data—open, high, low, close, VWAP, and volume—for a pair over timeframes that run from 1 minute up to 15 days, and you can even ask for data starting at a specific time.

**`get_order_book`** displays the current order book for any pair, showing price and volume at various levels of market depth.

**`get_trades`** pulls up to 1000 of the most recent completed trades for a pair, giving you the price, volume, and whether the trade was a buy or a sell.

**`get_spread`** returns the recent bid/ask spreads, so you can gauge the immediate liquidity and what it costs to trade a pair.

**`get_asset_info`** retrieves specific details about a crypto, giving you its name, alternate names, and how many decimal places it uses.

**`get_asset_pairs`** provides info on trading pairs, including the base and quote assets, lot volume decimals, and the trading leverage available.

**`get_server_time`** just gives you the current Unix timestamp and the formatted time straight from the Kraken server.

You can use **`get_asset_info`** to look up details on any crypto, and **`get_asset_pairs`** to see all the trading pairs available, including minimum lot sizes. You'll also get the best bid/ask prices, 24-hour volume, VWAP, and high/low for multiple pairs using **`get_ticker`**. For deep analysis, **`get_ohlc`** gives you historical candlestick data across multiple timeframes, and **`get_order_book`** lets you analyze market depth by showing specific price levels and volumes of bids and asks up to 500 levels deep. You can review recent transactions with **`get_trades`**, which pulls up to 1000 of the most recent trades for a pair, including price, volume, and if the trade was a buy or a sell. **`get_spread`** helps you assess the immediate liquidity and potential trading costs for a pair by analyzing recent bid/ask spreads. Finally, **`get_server_time`** gives you the current Unix timestamp and formatted time straight from the Kraken exchange server.

## Tools

### get_asset_info
Retrieves details about a cryptocurrency, including its name, alternate names, and decimal specifications.

### get_asset_pairs
Gets information on trading pairs, including their base/quote assets, lot volume decimals, and trading leverage.

### get_ohlc
Fetches candlestick data (open, high, low, close, VWAP, volume) for a specified pair and time interval (1m to 15d).

### get_order_book
Displays the current order book for a pair, showing price and volume at various levels of market depth.

### get_server_time
Returns the current Unix timestamp and formatted time from the Kraken exchange server.

### get_spread
Returns recent bid/ask spreads, useful for assessing the immediate liquidity and cost of trading a pair.

### get_ticker
Provides the best bid/ask prices, last trade price, 24h volume, VWAP, and high/low for multiple pairs.

### get_trades
Retrieves up to 1000 of the most recent completed trades for a pair, including price, volume, and side.

## Prompt Examples

**Prompt:** 
```
What is the current price of Bitcoin in USD?
```

**Response:** 
```
BTC/USD (XBTUSD): Last trade at $87,234.50. 24h high: $88,100, 24h low: $85,800. 24h volume: $1.2B. Best bid: $87,230, Best ask: $87,240. VWAP: $87,050.
```

**Prompt:** 
```
Show me the 1-hour OHLC for Ethereum over the last 24 candles.
```

**Response:** 
```
ETH/USD 1H candles (last 24): Current candle open: $3,245, high: $3,260, low: $3,230, close: $3,252. 24h volume: $450M. The trend has been upward over the past 24 hours with a 1.8% gain from $3,195.
```

**Prompt:** 
```
What are the recent trades for SOL/USD?
```

**Response:** 
```
Recent SOL/USD trades: $185.50 (buy, 12.5 SOL), $185.45 (sell, 8.2 SOL), $185.55 (buy, 25 SOL), $185.40 (sell, 15 SOL), $185.60 (buy, 5.3 SOL). Total volume in last 10 trades: ~250 SOL.
```

## Capabilities

### Check current market prices
Get the best bid/ask prices, last trade price, 24h volume, VWAP, and high/low for specific trading pairs.

### Analyze market depth
View the current order book, showing specific price levels and volumes of bids and asks up to 500 levels deep.

### Fetch historical candlestick data
Retrieve OHLCV data for a pair across multiple timeframes, from 1 minute to 15 days, and request data since a specific timestamp.

### Review recent transactions
Get up to 1000 of the most recent trades for a pair, including price, volume, and if the trade was a buy or sell.

### Gauge market liquidity
Analyze recent bid/ask spreads to understand the current liquidity and potential trading costs for a pair.

### Get asset and pair specifications
Look up details on individual cryptocurrencies, their decimals, and all available trading pairs, including minimum lot sizes.

## Use Cases

### Comparing crypto volatility across multiple assets
You need to know if ETH is moving more than SOL today. Instead of checking three different sites, ask your agent to run `get_ticker` for both pairs. The agent returns a single, clean summary listing the 24h high/low and current prices for both, letting you compare volatility immediately.

### Investigating a sudden price dip
The price of BTC/USD dropped suddenly. You need to know if it was a single large sell or a sustained trend. Run `get_ohlc` for the last 6 hours (1h interval) and then use `get_trades` to see the 50 most recent trades. This combination tells you if the dip was caused by a few big sell orders or by general market selling pressure.

### Building a dashboard for new crypto pairs
A developer needs to build a new dashboard for a niche pair like ADA/USD. First, they use `get_asset_pairs` to confirm the pair's specs. Then, they use `get_ticker` and `get_order_book` to gather the live data points needed to populate the initial view.

### Checking the true liquidity of a market
Before executing a large trade, you must know if the market can handle your volume. You run `get_order_book` to see the current bid/ask levels. Then, you run `get_spread` to quantify the average cost of executing that trade, giving you a full picture of the cost.

## Benefits

- See real-time market metrics instantly. Use `get_ticker` to pull the best bid/ask prices, 24h volume, and VWAP for multiple pairs in one query.
- Analyze market depth accurately. `get_order_book` shows current bids and asks, letting you see exactly where the money is sitting before you trade.
- Track long-term trends. `get_ohlc` lets you fetch candlestick data for any pair across 1-minute to 15-day intervals, making chart analysis simple.
- Monitor trading activity. `get_trades` pulls the 1000 most recent trades, so you don't have to scroll through a complex exchange interface to see what just happened.
- Check market readiness. Use `get_spread` to quickly assess bid/ask spreads, helping you judge the true cost and liquidity of a pair.
- Validate your symbols. Run `get_asset_info` to confirm the correct name and decimal structure for any crypto asset before running a complex analysis.

## How It Works

The bottom line is: you ask your agent for crypto data, and it pulls the current market metrics from Kraken without needing you to manage keys or interact with a separate dashboard.

1. Subscribe to the Kraken server and connect your AI client.
2. Your agent initiates a query, specifying the trading pair and desired data (e.g., 'Give me the OHLC for BTC/USD').
3. The MCP Server executes the necessary tool, returning structured, real-time market data directly to your AI client.

## Frequently Asked Questions

**Do I need an API key?**
No! All public market data (tickers, OHLC, trades, order book, spreads, asset info) is available without authentication. Just subscribe and start querying.

**What trading pairs are available?**
Kraken supports 500+ trading pairs including major pairs like XBT/USD, ETH/USD, ETH/XBT, SOL/USD and many altcoin pairs. Use get_asset_pairs to see the complete list.

**What timeframes are available for OHLC data?**
OHLC data is available in these intervals: 1 (1 minute), 5, 15, 30, 60 (1 hour), 240 (4 hours), 1440 (1 day), 10080 (1 week), 21600 (15 days). Use get_ohlc with the interval parameter.

**What is the difference between XBT and BTC?**
They're the same cryptocurrency! XBT is the ISO 4217 standard code for Bitcoin used by Kraken's API, while BTC is the common ticker symbol. Kraken pairs use XBT (e.g., XBTUSD = Bitcoin/US Dollar).

**How do I use `get_order_book` to analyze market depth?**
The `get_order_book` tool provides current bids and asks. You can pass the `count` parameter to specify how many price levels you want returned, useful for analyzing market depth and liquidity.

**What does `get_ohlc` return if I request incremental data?**
The `get_ohlc` tool returns a new candle with time, open, high, low, close, VWAP, volume, and trade count. Providing a `since` timestamp allows you to get data starting from a specific point in time.

**Can I check the server time using `get_server_time`?**
Yes, `get_server_time` returns both the Unix timestamp and the RFC 1123 time. This helps you synchronize your local system clock with the exchange server.

**How can I analyze spread data with `get_spread`?**
`get_spread` returns recent spread data, including bid price, ask price, time, and volume. This helps you assess the current liquidity and associated trading costs.