perpwatch

Name: perpwatch
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords金融数据01 周前更新

代码仓库

关于 perpwatch

perpwatch 是 MarketTrace 永续期货微观结构数据源的转发客户端，面向分析加密市场状况和交易流的用户。它在本地验证调用，并将十一个只读工具的请求转发至聚合 Binance、Bybit、OKX 和 Hyperliquid 数据的端点。

主要功能

01资金费率、未平仓量和市场快照
02条件结果与市场状态历史
03清算、成交量分布和大额交易
04足迹事件与堆叠失衡
05本地交易对验证和命令行

适用场景

01查看支持交易对的资金费率和未平仓量
02研究历史市场状态及条件收益
03检查近期清算和大额交易
04分析成交量分布和订单簿足迹事件

MCP 相关

它通过 stdio MCP 服务提供十一个只读工具，并将调用转发至托管的 MarketTrace 端点。数据请求需要 `MARKETTRACE_BEARER` bearer 令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-perpwatch": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/perpwatch"
      ]
    }
  }
}

启动命令npx -y @reneturcios/perpwatch

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/perpwatch0.1.0stdio

ocighcr.io/cloudcorprecords/perpwatch:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
symbol	string	是	资产符号：BTC、ETH、SOL、BNB、XRP、DOGE、HYPE、ZEC 或 ENA（不区分大小写；也接受 `USDT` 后缀，例如 `BTCUSDT`）。

详细介绍

perpwatch

MarketTrace 永续期货微观结构行情的转发客户端。perpwatch 将该行情的 11 个只读工具作为 stdio MCP 服务（以及一个小型 CLI）提供：它会在本地验证每次调用，包括九种交易品种（BTC、ETH、SOL、BNB、XRP、DOGE、HYPE、ZEC、ENA；不区分大小写，可选添加 USDT 后缀），然后将调用转发到托管端点，由该端点汇总 Binance、Bybit、OKX 和 Hyperliquid 的数据。

按工具所回答的问题分类：

市场背景 — get_market_state（单个标准化快照：资金费率及百分位、OI、成交量、CVD、订单簿失衡、清算压力、基差）、get_funding_percentile
历史与基准概率 — get_conditional_outcomes（给定条件后测得的远期收益；证据过少时返回 history_silent）、get_state_history（15 分钟状态存档序列）、get_ohlcv（合并后的 K 线）
资金流与足迹 — get_liquidations_recent、get_volume_profile（POC / 价值区域 / 裸 POC）、get_big_trades、get_footprint_events（被吸收 / 撤走的订单簿墙）、get_stacked_imbalances
help — 工具指南，在本地提供，无需凭据：按问题归类的工具、示例调用、量表和限制。

身份验证

托管端点使用 OAuth 登录（浏览器 → 电子邮件魔术链接）。完成登录并导出生成的 bearer：

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 表示运行时错误（包括缺少 bearer 或上游错误），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