perpwatch

perpwatch

MarketTrace 無期限先物マイクロストラクチャーフィード用の転送クライアントです。perpwatch は、フィードの読み取り専用ツール11個を stdio MCP サーバー（および小規模な CLI）として公開します。9銘柄のユニバース（BTC、ETH、SOL、BNB、XRP、DOGE、HYPE、ZEC、ENA。大文字・小文字を区別せず、USDT サフィックスは任意）を含む各呼び出しをローカルで検証し、Binance、Bybit、OKX、Hyperliquid のデータを集約するホスト型エンドポイントにプロキシします。

回答する質問別のツール：

• 市場の状況 — get_market_state（正規化されたスナップショット1件：ファンディング＋パーセンタイル、OI、出来高、CVD、板の不均衡、清算圧力、ベーシス）、get_funding_percentile
• 履歴と基準率 — get_conditional_outcomes（指定された条件後に測定されたフォワードリターン。証拠が不十分な場合は history_silent）、 get_state_history（15分間隔の市場状態アーカイブ系列）、 get_ohlcv（統合ローソク足）
• フローとフットプリント — get_liquidations_recent、 get_volume_profile（POC／バリューエリア／未再訪POC）、 get_big_trades、get_footprint_events（吸収／撤退された板の壁）、get_stacked_imbalances
• help — ツールガイド。認証情報不要でローカルに提供されます。質問別のツール分類、呼び出し例、尺度、制限を掲載しています。

認証

ホスト型エンドポイントでは OAuth サインイン（ブラウザー → メールのマジックリンク）を使用します。サインインを完了し、取得したベアラートークンをエクスポートします。

export MARKETTRACE_BEARER="<bearer from the hosted sign-in>"

認証情報がない場合、データ呼び出しは MARKETTRACE_BEARER とサインインについて示すエラーで失敗します。データが捏造されることはありません。エンドポイントのデフォルトは https://api.markettrace.ai/mcp です。MARKETTRACE_MCP_URL で上書きできます。市場データは情報提供のみを目的としており、金融アドバイスではありません。

CLI

npx @reneturcios/perpwatch tools
npx @reneturcios/perpwatch help
npx @reneturcios/perpwatch call get_market_state '{"symbol":"BTC"}'
npx @reneturcios/perpwatch --version

終了コード：0 は成功、1 は実行時エラー（ベアラーの欠落やアップストリームエラーを含む）、2 は使用方法のエラーです。

MCP サーバー

npx -y @reneturcios/perpwatch mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "perpwatch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/perpwatch", "mcp"],
      "env": { "MARKETTRACE_BEARER": "<bearer from the hosted sign-in>" }
    }
  }
}

Docker

docker run -i -e MARKETTRACE_BEARER="<bearer>" ghcr.io/cloudcorprecords/perpwatch

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios