# Okx

> Okx is a freemium MCP server for finance and payments. Keyless OKX market data tools for prices, order books, candles and derivatives metrics. It can run locally on your machine or as a hosted remote server.

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

## About

The README says this server wraps OKX's v5 public market endpoints so an AI client can pull spot, margin, swap, futures and option data without its own exchange credentials. Tools cover instrument lists, tickers, order books, recent trades, OHLC candles from 1 minute to 1 month, index prices, and mark prices.

For perpetual swaps it adds funding rate and funding history, open interest, taker buy/sell volume with cumulative volume delta, and long/short account ratios. Symbols can be written in several house styles, and responses name the OKX contract they resolved to, since figures differ between venues.

It is aimed at developers and analysts who want live or historical OKX market context inside an agent workflow. The server is an unofficial integration that runs through the Pipeworx gateway, so calls are metered by that gateway.

## Features

- **Live tickers and order books:** Fetches single or bulk tickers and bid/ask depth for OKX instruments.
- **Historical candles:** Returns OHLC bars from 1 minute to 1 month for charting and backtesting.
- **Perpetual funding data:** Provides current and historical funding rates for perpetual swaps.
- **Derivatives positioning metrics:** Covers open interest, taker buy/sell volume with CVD, and long/short account ratios.
- **Mark and index prices:** Exposes mark prices used for P&L and liquidation maths, plus index tickers.
- **Exchange status checks:** Offers server time and system maintenance status for connectivity checks.

## Good for

- Pull current OKX prices and depth for a trading dashboard
- Backtest strategies against historical OKX candles
- Track perpetual funding costs over time
- Monitor open interest and taker flow on a perpetual contract
- Check OKX maintenance windows before running automated jobs

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `instruments`: List instruments by type.
- `ticker`: Single instrument ticker.
- `tickers`: Bulk tickers by instrument type.
- `order_book`: Order book depth for an instrument.
- `candles`: OHLC candles for an instrument.
- `trades`: Recent trade tape for an instrument.
- `market_24hr`: 24-hour rolling stats for an instrument.
- `index_tickers`: Index tickers filtered by quote currency or instId.
- `funding_rate`: Current perpetual swap funding rate.
- `funding_rate_history`: Historical perpetual swap funding rates.
- `mark_price`: Mark price for derivatives.
- `perp_metrics`: Funding, open interest, taker volume and long/short ratio in one call.
- `open_interest`: Open interest for a perpetual or dated futures contract.
- `taker_volume`: Taker buy vs sell volume with CVD.
- `long_short_ratio`: Long/short account ratio for a perpetual contract.
- `time`: OKX server time in Unix milliseconds.
- `status`: OKX system status and maintenance windows.

## FAQ

### Does it need an OKX API key?

The README describes the market endpoints as keyless. An optional Pipeworx API key raises the daily call cap.

### How many calls can an anonymous user make per day?

The README says anonymous calls are capped at 50 per day, and a free account raises that to 200.

### Is it an official OKX product?

No. The README says it is an independent, unofficial integration not endorsed by OKX.

### Is Okx free?

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

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

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

### What are the best alternatives to Okx?

The closest alternatives to Okx are OKX MCP Server, Kraken, ApexTick Market Data & Options MCP, Crypto Derivatives Data API and Twelvedata.

## 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

- [OKX MCP Server](https://ai-powered.com/mcp/okx-mcp-server): OKX MCP Server is an open-source MCP server for crypto and web3.
- [Kraken](https://ai-powered.com/mcp/kraken): Kraken is a freemium MCP server for crypto and web3.
- [ApexTick Market Data & Options MCP](https://ai-powered.com/mcp/apextick-market-data-and-options-mcp): ApexTick Market Data & Options MCP is a freemium MCP server for finance and payments.
- [Crypto Derivatives Data API](https://ai-powered.com/mcp/crypto-derivatives-data-api): Crypto Derivatives Data API is a paid MCP server for finance and payments.
- [Twelvedata](https://ai-powered.com/mcp/twelvedata): Twelvedata is a freemium MCP server for finance and payments.
- [XOOMAR market data](https://ai-powered.com/mcp/xoomar-market-data): XOOMAR market data is a freemium MCP server for finance and payments.
- [Gemini Crypto](https://ai-powered.com/mcp/gemini-crypto): Gemini Crypto is a freemium MCP server for ai models and llm tooling.
- [Kronos Crypto Data](https://ai-powered.com/mcp/kronos-crypto-data): Kronos Crypto Data is a paid MCP server for finance and payments.

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