# Bitfinex

> Bitfinex is a freemium MCP server for crypto and web3. Read-only Bitfinex market data (tickers, books, trades, candles) for AI assistants. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/bitfinex
- **Repository:** https://github.com/pipeworx-io/mcp-bitfinex
- **MCP Registry name:** io.github.pipeworx-io/bitfinex
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-18

## About

The README says this server wraps Bitfinex's v2 public market endpoints, so it reads prices, order books, trades, candles and derivatives status without needing an exchange account. Tools cover live and historical tickers, recent trade tape, depth-of-book snapshots, OHLC candles across timeframes from one minute to one month, and forced liquidation history.

It is hosted by Pipeworx, an MCP gateway, and the endpoint is reached over streamable HTTP or through a local npm stdio bridge. The listing notes that the endpoint also exposes shared gateway meta-tools such as ask_pipeworx alongside the pack's own tools.

It suits developers and analysts who want an assistant to pull Bitfinex market figures for charting, microstructure analysis or backtesting. It does not place orders or access private account data.

## Features

- **Live ticker data:** Returns bid, ask, last price, daily change and volume for one or many trading pairs.
- **Order book depth:** Provides price levels with size and order count at several precision settings.
- **Trade tape access:** Lists recent executions with trade ID, timestamp, amount and price.
- **OHLC candles:** Serves open, high, low, close and volume data across timeframes from 1 minute to 1 month.
- **Derivatives and liquidations:** Covers perpetual contract status, its history, and the historical liquidation feed.
- **Optional API key:** An optional Pipeworx key raises the daily call cap for anonymous use.

## Good for

- Pull current bid and ask spreads for a trading pair
- Analyse order book depth for market microstructure research
- Chart historical candles for technical analysis
- Backtest a strategy against Bitfinex price history
- Monitor liquidation events on perpetual markets

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bitfinex https://gateway.pipeworx.io/bitfinex/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/bitfinex/mcp
```

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

```json
{
  "mcpServers": {
    "bitfinex": {
      "url": "https://gateway.pipeworx.io/bitfinex/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "bitfinex": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/bitfinex/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bitfinex": {
      "serverUrl": "https://gateway.pipeworx.io/bitfinex/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bitfinex": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/bitfinex/mcp"
    }
  }
}
```

## Tools

- `tickers`: Multi-symbol tickers, comma-separated or ALL.
- `ticker`: Single ticker for one pair.
- `ticker_history`: Historical ticker snapshots.
- `trades`: Recent trade tape for a pair.
- `book`: Order book snapshot with precision settings.
- `stats`: Statistics by key.
- `candles`: OHLC candles by timeframe.
- `derivatives_status`: Perpetual contract status.
- `derivatives_status_history`: Historical derivatives status.
- `liquidations`: Historical forced liquidations feed.
- `platform_status`: Bitfinex platform status.

## FAQ

### Does this server need a Bitfinex account or API key?

No. The README says the market endpoints are keyless. An optional Pipeworx API key only raises the daily call limit.

### Can it place trades?

The listed tools are all public market data reads; no order placement tool is listed.

### How many calls can I make without signing up?

The README and pricing page state anonymous use is capped at 50 tool calls a day, and a free account raises that to 200.

### Which timeframes are available for candles?

The README lists 1m, 5m, 15m, 30m, 1h, 3h, 6h, 12h, 1D, 1W, 14D and 1M.

### Is Bitfinex free?

Bitfinex has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add --transport http bitfinex https://gateway.pipeworx.io/bitfinex/mcp

### What are the best alternatives to Bitfinex?

The closest alternatives to Bitfinex are Bitstamp, Kraken, Gemini Crypto, Coinbase Exchange and Okx.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Bitstamp](https://ai-powered.com/mcp/bitstamp): Bitstamp is a freemium MCP server for crypto and web3.
- [Kraken](https://ai-powered.com/mcp/kraken): Kraken is a freemium MCP server for crypto and web3.
- [Gemini Crypto](https://ai-powered.com/mcp/gemini-crypto): Gemini Crypto is a freemium MCP server for ai models and llm tooling.
- [Coinbase Exchange](https://ai-powered.com/mcp/coinbase-exchange): Coinbase Exchange is a freemium MCP server for crypto and web3.
- [Okx](https://ai-powered.com/mcp/okx): Okx is a freemium MCP server for finance and payments.
- [PolyTest](https://ai-powered.com/mcp/polytest): PolyTest is a freemium MCP server for analytics and data.

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