Okx

@pipeworx/okx

OKX v5 MCP — API キー不要の公開市場エンドポイントです。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続する MCP ゲートウェイです。

ツール

• instruments(instType, uly?, instFamily?, instId?) — 商品一覧（SPOT|MARGIN|SWAP|FUTURES|OPTION）
• ticker(instId) — 単一のティッカー（例：BTC-USDT）
• tickers(instType, uly?, instFamily?) — 種類別ティッカー
• order_book(instId, sz?) — オーダーブック
• candles(instId, bar?, after?, before?, limit?) — OHLC（bar は 1m|3m|5m|15m|30m|1H|2H|4H|6H|12H|1D|1W|1M|3M）
• trades(instId, limit?) — 直近の取引
• market_24hr(instId) — 24時間ティッカー
• index_tickers(quoteCcy?, instId?) — インデックスティッカー
• funding_rate(instId) — 現在のファンディングレート（無期限スワップ）
• funding_rate_history(instId, before?, after?, limit?) — 過去のファンディングレート
• mark_price(instType, uly?, instId?) — マーク価格
• perp_metrics(instId, period?, buckets?) — 1回の呼び出しでファンディングレート＋建玉＋テイカーの買い／売り（CVD）＋ロング／ショートの口座比率を取得
• open_interest(instId, instType?) — 未決済コントラクト数、コイン数量、USD建て想定元本
• taker_volume(instId, period?, buckets?, unit?) — テイカーの買いと売りの出来高、買い／売り比率、および期間中のCVD
• long_short_ratio(instId, period?, buckets?) — ロング口座とショート口座の比率
• time() — システム時刻
• status() — システムステータス

データソース

https://www.okx.com/api/v5/public および /market

シンボル

上記のデリバティブツール4つでは、よく使われる表記ならどの形式で無期限契約を指定しても受け付けます。MASKUSDT（Binance形式）、MASK、MASK/USDT、MASK-USDT、MASK-USDT-SWAP は、すべてOKXのコントラクト MASK-USDT-SWAP に解決されます。すべてのレスポンスには、取引所名と解決された instId が含まれます。BinanceやBybitで取引されるコインを指定しても、ここではOKX独自のコントラクトが返され、数値は取引所によって異なるためです。Binanceの無期限契約エンドポイントはCloudflareのエグレスからのリクエストを拒否するため（403）、Binance固有のテイカー買い／売り内訳は提供できません。

不明なコントラクトの場合、空の成功レスポンスではなく、解決された instId とヒントを含む {found: false, reason: "instrument_not_found"} が返されます。OKX自体は不正な商品に対して、HTTP 200と code: "51001" を返します。

列の順序（テイカー出来高）

/rubik/stat/taker-volume-contract は [ts, sellVol, buyVol] を返します。売りが先です。2026-08-22に、ライブの /market/trades テープを MASK-USDT-SWAP の5分単位のビンに集計し、エンドポイントの値と完全に一致することを確認しました。列の順序を逆に読むと、CVDの符号が気付かないうちに反転します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/okx/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、およそ30個の共有ツールが表示されます。接続の initialize レスポンスには正確な対象範囲が記載され、その日の状況を確認するための正式な情報源となります。

これは意図的な動作であり、偶然の多重化ではありません。メタツールを使えば、このパックでは対応していない質問にも、カタログ全体を横断してルーティングする ask_pipeworx を介して回答できます。2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます：

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

どちらの URL も、同じゲートウェイと同じ1683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx は、どちらからでもすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/instruments \
  -H 'Content-Type: application/json' \
  -d '{"instType":"SPOT"}'

最初の呼び出しではアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/instruments を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も必要ありません。

{
  "mcpServers": {
    "okx": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-okx"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-okx

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントだけでなく、ゲートウェイ全体でも使用できます。

ask_pipeworx({ question: "your question about Okx data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT