# Bybit MCP for AI Agents MCP

> Bybit gives your AI agents instant access to live crypto market data. You pull real-time tickers, view candlestick charts (OHLCV) for technical analysis, and track the current orderbook depth for any trading pair. It also provides deep dives into derivatives metrics like funding rates and open interest—all without needing an API key for public market information.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** cryptocurrency, market-data, trading-pairs, orderbook, real-time-sync, derivatives

## Description

This MCP lets your agent read the live pulse of the crypto markets directly from Bybit. You don't need to mess with API keys just to check prices or view historical charts; it handles all that in plain language. Want to see how volatile BTC has been? Just ask for kline data across different timeframes, or check the current orderbook depth before making a trade decision. Need to know if perpetual contracts are expensive right now? Get the latest funding rates history and track open interest changes over time. Since Vinkius hosts this MCP in their catalog, you just connect your preferred AI client once and instantly get access to all this critical market intelligence.

## Tools

### get_funding_history
Retrieves a historical record of funding rates for perpetual contracts.

### get_index_price_kline
Fetches candlestick data representing the composite index price across multiple exchanges.

### get_instruments
Lists all available trading pairs and contract specifications from Bybit's market.

### get_kline
Gets detailed candlestick data (OHLCV) for technical analysis across spot, linear, or inverse markets.

### get_mark_price_kline
Provides candlestick data specifically calculated using the mark price, which is key for derivatives liquidation checks.

### get_open_interest
Tracks how many total open positions exist over time for a specific derivatives contract.

### get_orderbook
Displays the current market depth by returning active buy bids and sell asks at different price levels.

### get_recent_trades
Returns a list of the latest executed trades, including size, side (buy/sell), and timestamp for tracking order flow.

### get_server_time
Provides the current official Bybit server time to ensure accurate request synchronization.

### get_tickers
Retrieves real-time market prices and metrics for any specific crypto trading pair across all contract types.

## Prompt Examples

**Prompt:** 
```
What is the current trading activity on BTCUSDT?
```

**Response:** 
```
**BTCUSDT Market Snapshot**

*   **Current Price:** $104,250.00 (Up 2.34% today)
*   **Orderbook Depth:** 
    *   Bids: 15 BTC @ $104,248; 50 BTC @ $104,245
    *   Asks: 20 BTC @ $104,260; 30 BTC @ $104,270
*   **Latest Trades:** Last five trades show heavy selling pressure on the bid side.
```

**Prompt:** 
```
Show me the funding rates and open interest for ETHUSDT.
```

**Response:** 
```
**ETHUSDT Derivatives Health Check**

*   **Funding Rate:** 0.012% (Positive rate means longs pay shorts. Next payment in 4 hours.)
*   **Open Interest Trend:** Open interest has increased by 5,000 ETH over the last 4 hours across linear contracts.
*   **Analysis:** The rising open interest paired with a positive funding rate suggests significant new long capital is entering the market.
```

**Prompt:** 
```
I need candlestick data for the last 7 days on BTCUSDT.
```

**Response:** 
```
**BTCUSDT Daily Candles (Last Week)**

| Date | Open | High | Low | Close |
| :--- | :--- | :--- | :--- | :--- |
| Mon | $100k | $102k | $99k | $101.5k |
| Tue | $101.5k | $103k | $101k | $102.8k |
| Wed | $102.8k | $104k | $102.5k | $103.9k |
| Thu | $103.9k | $104.5k | $103.5k | $104.1k |
| Fri | $104.1k | $106k | $104k | $105.8k |
| Sat | N/A | N/A | N/A | N/A |
| Sun | N/A | N/A | N/A | N/A |

*Data is sourced from the main exchange index price.*
```

## Capabilities

### Fetch real-time pricing metrics
Get current prices, 24h ranges, and volume for any trading pair using the `get_tickers` tool.

### Analyze historical price patterns
Retrieve candlestick (OHLCV) data across various timeframes with `get_kline` to analyze market trends.

### View current market depth and liquidity
Check the bids and asks using `get_orderbook`, which shows exactly where buying and selling pressure exists right now.

### Track derivatives funding rates
Use `get_funding_history` to see how much longs pay shorts over time for perpetual contracts.

### Examine open interest changes
Monitor total open positions with `get_open_interest` across different contract types.

## Use Cases

### Checking pre-trade risk exposure
Before running a simulated trade, ask your agent to use `get_orderbook` along with `get_recent_trades`. This tells you if the market is thin and gives you an idea of immediate buying/selling pressure.

### Validating technical indicators
To verify a potential breakout, ask for historical OHLCV data using `get_kline` over multiple timeframes. You can then compare this to the mark price klines from `get_mark_price_kline`.

### Assessing perpetual contract health
If you suspect market divergence, ask for both funding rates (`get_funding_history`) and open interest data using `get_open_interest` to understand the long/short balance.

## Benefits

- Immediate market insight: Use `get_tickers` to get real-time prices, 24h changes, high/low, and volume for any pair instantly.
- Deep technical analysis: Pull detailed OHLCV data across various timeframes using `get_kline` for rigorous backtesting.
- Liquidity assessment: Check the current market depth and liquidity by calling `get_orderbook`, seeing exactly where bids and asks are clustered.
- Derivatives monitoring: Track complex metrics like funding rates via `get_funding_history` and open interest with `get_open_interest` for professional analysis.
- Comprehensive data access: The MCP covers spot, linear, inverse, and options markets, giving your agent one source for all trading pairs.

## How It Works

The bottom line is that you talk to your agent like a human talking to a colleague, and it handles all the complex crypto exchange calls for you.

1. Subscribe to the Bybit MCP in Vinkius and connect it to your AI client.
2. Your agent executes a request, specifying which data point is needed (e.g., 'Give me the last 10 daily candles for ETHUSDT').
3. The MCP pulls the real-time or historical market data and returns clean, structured information directly into your conversation.

## Frequently Asked Questions

**How can I use the Bybit MCP to check real-time crypto prices?**
You simply ask your agent for a specific pair, like Bitcoin. It uses `get_tickers` to give you immediate pricing, 24-hour changes, and volume metrics. This is perfect for quick market checks right in your chat window.

**Can I use Bybit MCP to check historical price trends?**
Yes. You can fetch detailed candlestick (OHLCV) data using `get_kline` across various timeframes, from 1-minute intervals up to monthly candles. This lets you run deep technical analyses.

**What is the best way to check market liquidity with Bybit MCP?**
You should use `get_orderbook`. This tool shows a live map of current bids and asks, letting you see exactly how much volume exists at specific price levels right now. It's key for understanding immediate trading risk.

**Does the Bybit MCP help with derivatives tracking?**
Absolutely. You can track complex metrics like funding rates (`get_funding_history`) and open interest movements (`get_open_interest`). This gives you visibility into the leveraged health of the market, which is crucial for advanced strategies.

**Is an API key required to use the Bybit MCP?**
No. For all the public market data—tickers, klines, orderbook, and trades—you don't need to manage or supply any private API keys when using this MCP.

**How do I know which contract types are available through Bybit MCP?**
You can call the `get_instruments` tool. It lists every available trading pair and contract type (spot, linear, inverse, etc.), helping you target your analysis correctly.