Skip to content
MCP server

CandleFeed

Binance futures candles, funding and L2 order book history for traders and quants

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.1.5
Listing updated
1 day ago

About CandleFeed

CandleFeed is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • CANDLEFEED_API_KEYYour CandleFeed API key. Get a free one at https://candlefeed.ai/signupRequired

What it does

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

Pricing

Freemium, from $24.17 a month

Free plan; Builder $290/yr, Advanced $990/yr, Pro $1,490/yr (L2 order book); Enterprise from $500/mo

Prices change. Check candlefeed.ai before you buy.

CandleFeed 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 to CandleFeed

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments