# CandleFeed

> CandleFeed is a freemium MCP server for finance and payments. Binance futures candles, funding and L2 order book history for traders and quants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $24.17 a month
- **Platforms:** API, CLI
- **Website:** https://candlefeed.ai/docs/order-book
- **MCP Registry name:** ai.candlefeed/candlefeed-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-16

## About

CandleFeed sells historical crypto derivatives data, and this MCP server is the way an assistant reaches it. The docs focus on daily Parquet files of Binance USD-M order book diffs, 1,000-level snapshots and tick trades, captured by three independent nodes and merged nightly into one checked file set per symbol and day. It is historical only, with no streaming endpoint.

The documentation spends real effort on correctness: separate exchange and receive timestamps, update-ID chains with segment markers where the stream broke, SHA-256 checksums, a public gap log and a worked procedure for rebuilding the book from a snapshot, including snapshots that land inside an event. The registry entry adds that candles, funding, open interest and liquidations are available, and the server needs a CandleFeed API key.

CandleFeed states it is not affiliated with or endorsed by Binance or any exchange whose data it shows.

## Features

- **L2 order book files:** Daily Parquet diffs plus snapshots of up to 1,000 levels per side for 25 symbols.
- **Tick trades:** Per-trade files with aggressor side and flags for rows recovered from REST.
- **Integrity checks:** Each day ships a manifest, gap log entries and SHA-256 checksums.
- **Two clocks:** Files carry Binance event times and the capture node's receive times.
- **Candles and derivatives data:** The registry entry lists candles, funding, open interest and liquidations.
- **Free sample days:** Every account can download the 1st of each month as an L2 sample.

## Good for

- Compute spread and depth from rebuilt order books
- Backtest strategies on perpetual futures candles and funding rates
- Measure feed latency using receive timestamps
- Check liquidation and open-interest history for a symbol

## Install

### Claude Code (Terminal)

```sh
claude mcp add candlefeed-mcp --env CANDLEFEED_API_KEY='<CANDLEFEED_API_KEY>' -- uvx candlefeed-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "candlefeed-mcp": {
      "command": "uvx",
      "args": [
        "candlefeed-mcp"
      ],
      "env": {
        "CANDLEFEED_API_KEY": "<CANDLEFEED_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "candlefeed-mcp": {
      "command": "uvx",
      "args": [
        "candlefeed-mcp"
      ],
      "env": {
        "CANDLEFEED_API_KEY": "<CANDLEFEED_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "candlefeed-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "candlefeed-mcp"
      ],
      "env": {
        "CANDLEFEED_API_KEY": "<CANDLEFEED_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "candlefeed-mcp": {
      "command": "uvx",
      "args": [
        "candlefeed-mcp"
      ],
      "env": {
        "CANDLEFEED_API_KEY": "<CANDLEFEED_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "candlefeed-mcp": {
      "command": "uvx",
      "args": [
        "candlefeed-mcp"
      ],
      "env": {
        "CANDLEFEED_API_KEY": "<CANDLEFEED_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Is there live data?

No. Files are historical and a day usually appears the morning after it ends in UTC.

### How much L2 data is there?

Book data starts 4 June 2026 for ten symbols and 26 September 2026 for fifteen more.

### What does it cost?

A free plan covers 30 days and the top 5 symbols. Paid tiers run from $290 to $1,490 per year, and L2 files come with Pro and Enterprise.

### Do I need a key?

Yes, the server requires a CandleFeed API key, and a free one is available on signup.

### Is CandleFeed free?

CandleFeed has a free plan, with paid plans for more usage or features. Paid plans start at $24.17 a month.

### How do I add CandleFeed to Claude Code?

Run this command in your terminal: claude mcp add candlefeed-mcp --env CANDLEFEED_API_KEY='<CANDLEFEED_API_KEY>' -- uvx candlefeed-mcp

### What are the best alternatives to CandleFeed?

The closest alternatives to CandleFeed are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/candlefeed
