关于 Coinversaa Pulse
Coinversaa Pulse 为 AI Agent 提供 Hyperliquid 钱包、交易历史、行为分群和实时市场数据查询。它还覆盖 HIP-4 合约、构建者分析及订单簿数据,需 API 密钥且功能受账户等级限制。
主要功能
- 01查询钱包、交易和盈亏归因
- 02分析交易者行为分群与生命周期
- 03查看 HIP-4 合约和结算信息
- 04分析构建者收入及用户群
- 05查询订单簿深度、价差和大额挂单
- 06查看数据覆盖范围与新鲜度
适用场景
- 01研究钱包的交易记录和盈亏表现
- 02比较不同交易者群体及交易行为
- 03检查 HIP-4 合约活动与结算
- 04分析构建者的收入和用户留存
MCP 相关
作为 MCP 服务,通过 MCP 兼容客户端提供 Hyperliquid 数据与分析工具。每个工具都需要 API 密钥,可用工具和限额取决于后端账户等级。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
26收录的工具列表 · 更新于 2 周前
此工具无需参数。
详细介绍
Coinversa Pulse — MCP 服务
为 AI Agent 提供加密货币情报。通过任何兼容 MCP 的客户端,查询完整的 Hyperliquid 钱包全貌、带有 PnL 归因的已索引交易历史、行为群组和实时市场数据。调用 pulse_global_stats 查看当前的精确覆盖情况(跟踪的钱包数、已索引交易数、交易量、PnL、数据时间范围)。
现已支持 HIP-4 结果合约和 builder dex——查看预测市场风格的结果合约、结算、商品(黄金、白银、石油)、股票(TSLA、AAPL)以及覆盖 8 个 dex 和 369+ 个市场的永续合约。
0.12.0 版本新增内容
L4 订单簿工具和数据集覆盖范围。 新增 5 个工具,并与托管连接器完全对齐,托管连接器地址为 https://mcp.coinversa.ai/mcp。
| 新工具 | 可解答的问题 |
|---|---|
book_summary [Pro] | “现在,X 币的挂单簿是什么样的——深度、价差、失衡情况如何?” |
book_levels [Pro] | “各个价位的挂单量分别集中在哪里?” |
book_whales [Pro] | “哪些钱包持有最大的挂单,挂单方向是什么?” |
book_stop_map [Pro] | “触发单集中在哪里,行情波动时会扫到哪些触发单?” |
data_coverage | “每个数据集覆盖什么时间范围,数据有多新?” |
工具数量:已注册 103 → 107 个,已公布 106 个(见下文)。
0.12.0 版本还包括:
- 默认隐藏
builder_heatmap。 在完成小时级汇总数据回填之前,其上游无法在客户端超时时间内返回结果,因此公布该工具只会导致超时。该工具仍包含在内:将COINVERSAA_HIDDEN_TOOLS=设为空(明确留空)即可公布所有工具;也可以指定另一个逗号分隔列表来隐藏其他工具。未设置此变量时,builder_heatmap将保持隐藏。 - 移除
pulse_market_overview。 它是list_markets的弃用别名;list_markets是规范的市场发现工具。 - 描述和参数已与托管连接器重新同步。 20 个工具描述和 7 个输入架构曾存在偏差;
live_mark_dislocations、pulse_cohort_bias_history、pulse_cohort_performance_daily、hip4_outcomes、hip4_trader_outcomes和pulse_lifecycle增加了托管连接器已有的分页和筛选参数,live_coin_risk_history则增加了include。
0.11.1 版本新增内容
Builder 用户生命周期、旅程、热力图和订单意向分析。 基于相同的 builder 费用数据新增 4 个工具,涵盖 builder 用户当前所处阶段、新钱包变现速度、实际成交时间,以及用户下单时的意图。
| 新工具 | 可解答的问题 |
|---|---|
builder_journey [Pro] | “Builder X 将新用户变现的速度有多快,过程有多不均衡?” |
builder_lifecycle [Pro] | “Builder X 有多少用户仍然活跃,又有多少被竞争对手夺走?” |
builder_heatmap [Pro] | “Builder X 的交易量在什么时段达到峰值,什么时候发布产品最稳妥?” |
builder_orders [Pro] | “Builder X 的用户会设置止损和止盈单吗?他们的订单流有多少实际成交?” |
工具数量:99 → 103 个。
0.11.1 版本还包括:
- 工具标题和注释——现在每个工具都带有易读的
title和 MCP 注释(readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: true),客户端可据此标注工具,并将其视为只读工具而无需提示确认。 - 与托管连接器对齐——此软件包现在提供的工具集与托管 OAuth 端点
https://mcp.coinversa.ai/mcp提供的完全一致。此仓库中原有的、基于请求头认证的过时 HTTP 入口点已移除;请参阅快速开始,了解两种受支持的连接方式。
0.11.0 版本更新
Builder 分析 — 新增 8 个工具(91 → 99)。 Hyperliquid 的 builder 代码经济(前端、钱包应用、机器人和 builder dexes 通过路由订单流赚取的手续费)现已成为一类一等工具:
builder_leaderboard— 按链上账本中的精确收入排列 builder,并显示归因交易量、用户数及上一窗口的变化 (Starter)builder_profile— 单个 builder 的收入、每日序列、热门币种和盈利用户占比 (Starter)builder_traders— 通过某个 builder 交易的钱包,并按全交易所的用户群层级分类 (Pro)builder_fills— 通过某个 builder 归因的单笔成交,涵盖 perp/spot/HIP-4 (Pro)builder_cohorts— 按行为层级划分某个 builder 的用户群 (Pro)builder_retention— 每月新用户留存三角表 (Pro)builder_overlap— 与该 builder 共享用户的其他 builder (Pro)trader_builders— 某个钱包通过其交易的所有 builder,按已付手续费排列 (Starter)
收入根据 Hyperliquid 自身累计的 builder 手续费账本计算(并与链上数据核对);成交级明细则来自订单→成交归因,每个响应中的 dataNotes 都会如实说明覆盖范围的注意事项。询问你的 Agent “MetaMask 的交易者还会使用哪些前端?”——没有其他数据源能回答这个问题。
0.10.0 版本更新
双词汇体系的用户群层级。 现在接受新的规范层级标识符,可用于所有以层级作为输入的地方——PnL 层级(apex、sharps、grinders、scrapers、crowd、bleeders、trapped、blown_out)和按规模划分的重量级别(heavyweights … strawweights)。旧标识符(money_printer、smart_money …)将始终有效;响应不变。无破坏性变更。
0.9.0 版本更新
实体解析、感知层级的会话,以及经链上验证的答案。
| 新工具 | 可回答的问题 |
|---|---|
pulse_entity_profile [Pro] | “这个钱包归谁所有——其所有子账户合并后的真实持仓情况如何?” |
pulse_entity_leaderboard [Pro] | “按所有者而非钱包去重后的顶级交易者——一个运营 35 个子账户的基金会显示为一个实体。” |
pulse_my_plan | “这个 API 密钥使用什么套餐、有哪些限制,以及升级后能解锁什么?” |
pulse_exchange_volume | “24 小时交易量——总量及各 dex 的交易量(builder dexes 约占 43%,大多数追踪器都漏掉了它们)。” |
pulse_exchange_oi | “按 dex 划分的未平仓量,并区分多头/空头。” |
pulse_active_traders | “过去 24 小时有多少个钱包进行过交易?” |
pulse_exchange_positions | “当前有多少个未平仓头寸,按 dex 划分?” |
pulse_pnl_leaders | “过去 24 小时全交易所范围内,谁的盈利和亏损最多?” |
0.9.0 版本还包括:
- 感知层级的错误 — 请求因层级限制或速率限制而失败时,现在会说明调用者的层级、所需层级,并附上直接升级链接。(修复有效的免费层级密钥在调用 Pro 端点时被告知密钥“已被拒绝”的问题。)
- 已验证状态与链上状态标记 — 实体响应会附带其上次核对所依据的链上状态区块。
工具数量:83 → 91。
0.8.0 新增内容
持仓生命周期、执行质量和交易者类型。 v0.8.0 新增了 28 个工具,这些工具基于完全重新推导的持仓生命周期数据集构建——从链上成交记录重建每个开仓→平仓周期,并新增 MAE/MFE(每个持仓经历过的最差不利价格和最佳有利价格)。这让执行质量分析成为可能,而不只是分析盈亏。
| 新工具 | 可以回答的问题 |
|---|---|
pulse_trader_lifecycles | “列出这个钱包的每个开仓→平仓持仓,包括入场价、出场价和持有时间。” |
pulse_trader_lifecycle_summary | “这个钱包在持仓层面的统计数据如何——胜率、平均持有时间、最大盈亏?” |
pulse_lifecycle | “详细分析生命周期 12345,列出构建和解除它的每笔成交。” |
pulse_trader_demo | “深入分析前,先快速了解这个钱包。” |
pulse_wallet_drawdown_curve | “这个钱包的每个持仓在盈利前曾经历多大的浮亏?” |
pulse_max_pain_events | “哪些盈利持仓在回升前承受了最深的回撤?” |
pulse_perfect_exits | “哪些出场捕获了最大有利波动中的大部分?” |
pulse_backstop_events | “最惨重的单笔清算有哪些?” |
pulse_survivors / pulse_anti_survivors | “谁曾爆仓后恢复——谁又再也没能恢复?” |
pulse_persistent_winners | “谁在多个不同月份持续盈利,而不是只走运一次?” |
pulse_capital_titans | “谁能以每美元手续费获得最多盈亏?” |
pulse_one_month_wonders | “谁有过一个月的巨额盈利,随后又全数亏回去?” |
pulse_newcomer_whales | “谁刚出现就已经在交易大额名义金额?” |
pulse_coin_kings | “每种币的头号赚钱者是谁?” |
pulse_top_liquidators | “谁通过清算他人获利最多?” |
pulse_lethal_coins | “哪些币最常让人爆仓?” |
pulse_coin_alpha_map | “每种币的赢家和输家利润池规模分别有多大?” |
pulse_hour_profitability | “哪个 UTC 平仓时段最赚钱?” |
pulse_market_concentration | “Alpha 有多集中——前 1% 的人是否拿走了所有收益?” |
pulse_style_distribution | “剥头皮交易者还是波段交易者赚得更多?” |
pulse_compare | “正面对比:A 和 B,谁是更优秀的交易者?” |
pulse_cohort_recent_* | “当前正在盈利的钱包(近 30 天分层)在做什么——持仓、交易、顶级生命周期、集中度如何?” |
pulse_lifecycles_recent | “整个交易所刚刚有哪些持仓平仓?”(全局动态;是 pulse_recent_closed_positions 的后继工具) |
旧版已平仓持仓工具(pulse_trader_closed_positions、pulse_trader_closed_position_stats、pulse_recent_closed_positions)仍保留以保持向后兼容,但生命周期工具已取代它们。这些新工具读取经过修正的 position_lifecycles_full 表,包含更多历史数据、MAE/MFE 和现货数据。
工具数量:55 → 83。每个工具都需要 API 密钥;后端分层机制决定可用的工具和限额。
0.7.0 版更新内容
HIP-4 结果合约智能分析。 v0.7.0 新增 12 个工具,可用于发现活跃结果合约、读取问题元数据、检查结算情况和近期成交、跟踪每日交易量、为结果交易者排名、衡量结果与永续合约的重叠情况,以及将结果持有者与其当前持有的同一基础资产永续合约仓位关联起来。
| 新工具 | 可回答的问题 |
|---|---|
hip4_outcomes | “目前有哪些活跃的结果合约?” |
hip4_outcome | “什么是结果 123?它使用哪些侧代币?” |
hip4_outcome_summary | “该结果的两侧总交易量/盈亏是多少?” |
hip4_outcome_recent_trades | “显示这个预测市场的近期成交。” |
hip4_questions | “有哪些 HIP-4 问题和命名结果?” |
hip4_recent_settlements | “近期结算了哪些结果?哪一侧获胜?” |
hip4_daily_volume | “HIP-4 结果交易量是否逐日增长?” |
hip4_most_active | “哪些结果合约最活跃?” |
hip4_top_traders | “哪些是顶尖结果交易者?” |
hip4_trader_outcomes | “这个钱包交易过哪些结果?” |
hip4_cross_product_overlap | “结果交易者和永续合约交易者之间的重叠程度如何?” |
hip4_perp_position_context | “结果 25 的交易者目前是否持有 BTC 永续合约敞口?该敞口是方向一致还是对冲?” |
工具数量:43 → 55。每个工具都需要 API 密钥;后端级别决定可用的工具和限制。请从 coinversa.ai/developers 获取密钥。
0.6.0 版更新内容
规范化的跨市场资产分类体系。 同一基础资产在不同交易场所可能使用不同的代码(例如,xyz 上的 GOLD 与 Hyperliquid 原生市场上的 PAXG 都追踪黄金)。v0.6.0 新增了 3 个工具,可在服务端解析同义代码并汇总跨交易场所的数据,此外还新增了一个真实数据源 OI 工具:
| 新工具 | 可回答的问题 |
|---|---|
list_assets | “有哪些可用资产?哪些资产在 2 个或更多交易场所上市?” |
list_asset | “GOLD 在哪里交易?PAXG 和 GOLD 是同一种资产吗?” |
pulse_cross_market_asset | “黄金在 xyz 还是 hyna 上更拥挤?不同去中心化交易所对 BTC 方向的判断是否存在分歧?” |
live_official_oi | “Hyperliquid 自身报告的 BTC OI 是多少?我们的数据是否一致?” |
内置同义代码:PAXG → GOLD、XAUT → GOLD、XAGT → SILVER。前缀归组(BTC ≡ flx:BTC ≡ hyna:BTC)会自动完成。
0.6.0 版的其他维护更新:默认 API URL 指向生产环境;移除了过时的硬编码宣传数据“710K+ wallets / 1.8B+ trades”(调用 pulse_global_stats 获取当前覆盖情况);将 pulse_market_overview 保留为规范工具 list_markets 的弃用别名。
快速开始
有两种连接方式。两者默认都会提供相同的 106 个只读工具,且都需要 Coinversa API 密钥(cvsa_...)——不提供无密钥层级。
| 方式 | 位置 | 身份验证 | 最适用于 |
|---|---|---|---|
| 托管远程 MCP(推荐) | https://mcp.coinversa.ai/mcp | 在浏览器中使用 OAuth 2.1——客户端无需处理密钥 | Claude.ai、Claude Desktop、Claude Code、Cursor、ChatGPT、Perplexity,以及任何 Streamable HTTP 客户端 |
| 本地 stdio MCP(此软件包) | npx -y @coinversaa/[email protected] | COINVERSAA_API_KEY 环境变量 | Codex 和其他仅支持 stdio 的客户端、隔离网络环境、开发 |
规范且始终保持最新的客户端指南位于 docs.coinversa.ai/mcp/setup。以下代码片段与该指南保持一致。
托管式远程 MCP(OAuth)
将 URL 粘贴到客户端,并将所有身份验证/标头字段留空。客户端会自动发现 OAuth 流程,并在浏览器中打开 Coinversa 授权页面。你可以:
- 点击 Sign in / Sign up & get a key——开发者门户会在弹出窗口中打开,你可以选择(或自动创建)一个密钥,随后一次性连接码会返回到授权页面;通过此流程,原始密钥不会传递给 MCP 服务;或
- 直接粘贴已有的
cvsa_密钥。
点击 Authorize 即可连接。新账户可免费获享 14 天 Pro,无需信用卡。在开发者门户中撤销密钥后,所有使用该密钥完成授权的 Agent 都会立即断开连接。
Claude.ai(网页)
- 打开 claude.ai/customize/connectors?modal=add-custom-connector。
- 名称:
Coinversa— URL:https://mcp.coinversa.ai/mcp。将身份验证字段留空。 - 点击 Add,然后点击 Connect;在 Coinversa 页面登录并点击 Authorize。
- 在新聊天中提问:“Coinversa Pulse 的全球交易统计数据是什么?”——Claude 应会调用
pulse_global_stats。
Claude Desktop
Claude Desktop 仅支持 stdio,因此请使用 mcp-remote 衔接程序,在 stdio ↔ HTTP 之间桥接并处理 OAuth 授权流程。编辑配置文件:
| 操作系统 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
{
"mcpServers": {
"coinversa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.coinversa.ai/mcp"]
}
}
}
完全退出并重新打开 Claude Desktop。首次连接时,mcp-remote 会在浏览器中打开 Coinversa 授权页面——登录并点击 Authorize。
Cursor
Cursor 原生支持 HTTP MCP 服务。将以下内容添加到 ~/.cursor/mcp.json(或项目中的 .cursor/mcp.json):
{
"mcpServers": {
"coinversa": {
"url": "https://mcp.coinversa.ai/mcp"
}
}
}
重启 Cursor,并在浏览器中批准授权提示。你也可以使用 developers.coinversa.ai/connect 上的一键式 Install in Cursor 深层链接。
Claude Code
claude mcp add --transport http coinversa https://mcp.coinversa.ai/mcp
然后在 Claude Code 中运行 /mcp,并为 coinversa 选择 Authenticate;浏览器授权流程与上文相同。
ChatGPT、Perplexity 和其他远程客户端
添加自定义连接器/远程 MCP 服务,URL 填写 https://mcp.coinversa.ai/mcp,且不添加标头。客户端首次使用时会打开 Coinversa 授权页面。
本地 stdio MCP(npx + API 密钥)
对于仅支持 stdio 的客户端(例如 Codex),或者你希望自行保管密钥时,可在本地运行此 npm 包。从开发者门户获取密钥。
{
"mcpServers": {
"coinversa": {
"command": "npx",
"args": ["-y", "@coinversaa/[email protected]"],
"env": {
"COINVERSAA_API_KEY": "cvsa_your_key_here"
}
}
}
}
也可以在 shell 中运行:
COINVERSAA_API_KEY=cvsa_... npx -y @coinversaa/[email protected]
这会通过 stdio 在本地运行相同的工具,并使用环境变量中的密钥进行身份验证,而非使用 OAuth。如果缺少 COINVERSAA_API_KEY,stdio 服务会在启动时退出。无需克隆,也无需构建——npx 会处理一切。
验证是否正常工作
向 Agent 提问:*“使用 Coinversa Pulse,显示本周 Hyperliquid 上总 PnL 排名前 5 的交易者。”*你应该会看到一次 pulse_leaderboard 调用,并返回排名地址。pulse_my_plan 会显示已连接密钥所属的套餐,以及各个等级包含的功能。如果 Agent 报告 401 错误,说明授权已过期或密钥已被撤销——重新连接该连接器,它会再次打开授权页面。
托管远程 MCP
端点:https://mcp.coinversa.ai/mcp — Streamable HTTP,无状态。每个 POST /mcp 请求都携带一个 JSON-RPC 请求(或批量请求),并在同一连接上接收响应;服务端没有可恢复的会话,因此 GET /mcp 和 DELETE /mcp 会返回 405 Method Not Allowed。没有 SSE 端点。
| 端点 | 方法 | 用途 |
|---|---|---|
/mcp | POST | MCP Streamable HTTP 端点(需要有效的 OAuth 访问令牌) |
/health | GET | 健康检查 — 返回 { ok, name, version } |
/.well-known/oauth-authorization-server | GET | OAuth 2.1 授权服务器元数据(RFC 8414) |
/.well-known/oauth-protected-resource/mcp | GET | 受保护资源元数据(RFC 9728)— 客户端会从 /mcp 返回的 401 响应中访问此端点 |
/authorize | GET | 授权端点;呈现同意页面 |
/token | POST | 令牌端点(authorization_code + PKCE、refresh_token) |
/register | POST | 动态客户端注册(RFC 7591) |
/revoke | POST | 令牌撤销(RFC 7009) |
托管服务由 Coinversa 运营,会使用你授权的密钥,代表你调用 Coinversa 第一方 API:https://api.coinversa.ai。它不是第三方代理。它提供与此软件包相同的工具定义(相同的名称、描述、输入架构、标题和注释 — 由 tests/toolParity.test.ts 强制确保一致);此仓库是 npm stdio 软件包的源代码仓库,不是托管 OAuth 服务本身的源代码仓库。
身份验证
托管端点只支持一种身份验证方式:采用 PKCE(S256)的 OAuth 2.1 和动态客户端注册。所有符合规范的客户端(Claude.ai、通过 mcp-remote 接入的 Claude Desktop、Claude Code、Cursor、ChatGPT、Perplexity)都能仅凭 URL 自动完成身份验证。
工作方式:
- 客户端在没有令牌的情况下向
/mcp发送POST请求,收到带有WWW-Authenticate标头的401响应。该标头指向受保护资源元数据,客户端可据此发现授权服务器。 - 客户端通过
/register注册自身(DCR),然后在浏览器中打开/authorize,并附上 PKCE 代码质询。 - 你会看到 Coinversa 同意页面。你可以粘贴
cvsa_密钥,也可以点击 Sign in / Sign up & get a key,这会在弹出窗口中打开开发者门户,并向同意页面返回一个短时有效、只能使用一次的连接码。在门户流程中,原始密钥不会传到 MCP 服务 — 服务只会存储密钥引用,由后端进行解析。 - 客户端会在
/token处使用授权码(以及 PKCE 验证码)换取令牌。
令牌详情:
| 令牌 | 格式 | 有效期 |
|---|---|---|
| 访问令牌 | 不透明、随机 | 1 小时 |
| 刷新令牌 | 不透明、随机,每次刷新后都会轮换 | 90 天,滚动续期 |
令牌会以哈希形式(SHA-256)存储在服务端。在开发者门户中撤销底层 API 密钥,会使使用该密钥授权的所有会话失效。
托管端点不支持基于标头的 API 密钥身份验证。跳过 OAuth 并在 Authorization 标头或自定义标头中放入原始 cvsa_ 密钥的请求会被拒绝,并返回 401。如果你想使用自己持有的密钥进行身份验证,请改为运行本地 stdio 服务(见上文);该服务会从其环境中读取 COINVERSAA_API_KEY,并自行将其发送给 Coinversa API。
隐私与数据处理
托管服务是一个轻量、无状态的桥接层,连接你的 MCP 客户端与 Coinversa API。
它存储的内容(存储在 Coinversa 基础设施上的 SQLite 数据库中):
- 通过动态客户端注册创建的 OAuth 客户端注册信息(客户端 ID、重定向 URI、客户端元数据)。
- 以 SHA-256 哈希形式存储的访问令牌和刷新令牌——明文令牌仅存在于你的客户端中。
- 每个令牌背后的 API 密钥授权:如果你通过开发者门户连接,存储的是密钥 ID(后端会解析的引用;不会存储密钥本身);如果你粘贴密钥连接,则会存储以 AES-256-GCM 加密的静态加密密钥,加密密钥位于数据库之外。
它绝不存储的内容:
- 对话内容。服务器只会看到正在处理的工具调用,不会看到你的聊天内容。
- 超出当前请求处理时长的工具参数或结果。不会将任何内容写入数据库,也不会记录参数。
- 钱包私钥、助记词、签名、交易所凭据或任何托管资产相关材料——没有工具会索要这些内容,也不存在此类信息。
本地 stdio 服务不会存储任何内容:它会在进程运行期间将 COINVERSAA_API_KEY 保存在内存中,并将每次工具调用转发至 Coinversa API。
**工具调用会向 Coinversa API 发送的内容:**你可以在每个工具的架构中看到的参数——市场符号、公开钱包地址、群组名称、HIP-4 结果 ID、构建者地址、时间窗口——以及用于授权和计量的 API 密钥。用量会计入该密钥所属的套餐;请参阅速率限制。
**范围:**所有工具均为只读,并标注为只读(readOnlyHint: true、destructiveHint: false)。该服务无法在 Hyperliquid 或 Coinversa 上下单、签署交易、转移资金、批准 Agent 或更改任何账户设置。
**撤销:**在开发者门户中撤销 API 密钥,即可断开所有使用该密钥授权的 Agent;也可以在客户端中移除连接器。客户端也可以调用 /revoke。
政策:coinversa.ai/privacy · coinversa.ai/terms。如有疑问或数据请求,请联系:[email protected]。
连接器目录
供目录审核人员和安全团队参考,信息汇总如下:
- 只读。 已注册 107 个工具,默认可用 106 个——全部为等效于
GET的分析工具;完全不具备写入、交易、转账或修改账户的能力。无法通过此连接器进行任何金融交易。 - **身份验证:**OAuth 2.1、PKCE S256、动态客户端注册、刷新令牌轮换。请求标头中不含 API 密钥,客户端配置中不含静态密钥。
- **数据源:**第一方数据——服务由 Coinversa 运营,且仅调用 Coinversa 自有的
api.coinversa.aiAPI(登录期间还会调用 Coinversa 开发者门户/后端)。不会调用第三方数据经纪商或大模型提供商。 - **传输方式:**可流式 HTTP(无状态
POST /mcp),仅使用 TLS。 - **数据保留:**哈希令牌、加密密钥或密钥 ID、DCR 客户端记录。不记录对话内容或参数。
- 源代码:github.com/coinversaa/mcp-server(MIT)——npm stdio 软件包,包含与托管连接器相同的工具定义。
- 支持:[email protected] · 隐私 · 条款
Builder Dex 市场
Hyperliquid 除原生永续合约交易所外,还支持多个 Builder Dex。每个 Dex 都有自己的市场、抵押代币和交易品种格式。
| Dex | 交易品种 | 抵押品 | 示例交易品种 |
|---|---|---|---|
| (原生) | 核心永续合约(加密货币) | USDC | BTC, ETH, SOL, HYPE |
xyz | 大宗商品、股票、指数 | USDC | xyz:GOLD, xyz:SILVER, xyz:TSLA |
flx | 永续合约 | USDH | flx:BTC, flx:ETH |
vntl | 永续合约 | USDH | vntl:ANTHROPIC, vntl:BTC |
hyna | 永续合约 | USDE | hyna:SOL, hyna:BTC |
km | 能源与大宗商品 | USDH | km:OIL, km:NATGAS |
abcd | 其他 | USDC | abcd:BITCOIN |
cash | 股票与权益证券 | USDT0 | cash:TSLA, cash:AAPL |
交易品种格式:
- 原生 Hyperliquid 交易品种:
BTC、ETH、SOL - Builder Dex 交易品种:
prefix:COIN——例如xyz:GOLD、cash:TSLA、hyna:SOL
使用 list_markets 工具,查看所有可用交易品种及其所属 Dex。
面向 Agent 交易者的后端交易说明:Coinversaa 后端签名的 Hyperliquid 订单使用经批准的 Hyperliquid Agent 钱包,而非 vaultAddress。如果后端签名者发生变更,请先在 Hyperliquid 上重新批准该签名者,再提交订单。Builder Dex 订单也可能要求使用统一账户模式,以便在受支持的 Dex 间共享 USDC 抵押品。对于仅支持逐仓的市场,省略 marginMode 时现在默认采用 isolated;请勿假设 Builder Dex 交易品种支持 cross。
前端账户模式说明:应用现在可以通过 POST /api/v1/hyperliquid/prepare-abstraction 准备由用户签名的抽象模式变更,让用户无需离开 Coinversa 即可启用或停用统一账户模式。Hyperliquid 仍可能因交易所侧原因拒绝该变更。
跨市场资产分类
同一种底层资产在不同交易场所可能使用不同代码(例如,xyz 上的 GOLD 和 hyna 上的 PAXG 都跟踪黄金)。Coinversa 提供规范资产注册表,让你无需自行重新设计分组逻辑。
- 规范资产——经济敞口标识符(
GOLD、BTC、ETH)。 - 交易品种——交易场所列出的名称(
xyz:GOLD、hyna:PAXG、BTC、flx:BTC)。 - 同义词(交易代码 → 规范资产):
PAXG → GOLD、XAUT → GOLD、XAGT → SILVER。
凡是涉及资产层面的问题(交易场所可用性、跨交易场所未平仓量、跨交易场所偏向分歧),请使用 list_assets / list_asset / pulse_cross_market_asset。单一交易场所查询请使用 list_markets / market_price。
分组方式:
- 不同交易场所使用相同代码(
BTC、flx:BTC、hyna:BTC)→ 自动归入规范资产BTC。无需配置。 - 代码不同但敞口相同(
PAXG和GOLD均跟踪 1 盎司黄金)→ 根据上述同义词表进行归并。 - 包装或质押变体(
WBTC、WETH、stETH、wstETH)→ 默认不进行汇总。它们的风险特征和流动性不同,应视为独立资产。
示例:汇总后的「GOLD」(实时快照,2026 年 4 月):
- 6 个交易场所:
xyz:GOLD(主导,未平仓量为 $149M)、PAXG(原生 HL,$39M)、cash:GOLD、km:GOLD、flx:GOLD、hyna:GOLD netBias: 0.27——各交易场所整体略偏多biasRange: 0.61——各交易场所对信念强度的判断存在明显分歧(任何回答中都值得指出)synonyms: ["GOLD", "PAXG"]——确认 PAXG 已正确并入规范资产 GOLD
以上数字仅用于说明——如需当前值,请调用 pulse_cross_market_asset 并设置 canonical: "GOLD"。
后端依赖
这 3 个资产工具会调用生产环境 Coinversa 后端(https://api.coinversa.ai)上的 /api/public/v1/assets* 端点。可自托管或分叉的部署需要运行一个提供这些路由的后端;参考实现请见 Coinversa 后端仓库。
可用工具(106)
所有工具都需要 API 密钥。MCP 注册了 107 个工具,默认宣传其中 106 个(builder_heatmap 暂不提供——参见0.12.0 版的新内容),Coinversa API 则根据密钥等级控制访问权限。免费 API 密钥可使用公开/发现路由,而 Starter、Pro 和 Enterprise 密钥可解锁更深入的交易员、HIP-4、风险、历史数据和官方 OI 工具。
风险工具数据时效性
由 Syncer 提供支持的风险工具,例如 live_risk_overview、live_coin_risk_snapshot、live_coin_risk_history、live_mark_dislocations、live_recent_liquidations、live_liquidation_summary、live_oi_history 和 live_cohort_bias_history,最好视为近期情报测试版工具。如需获取交易场所的真实 OI 数据,可通过 live_official_oi 直接从 Hyperliquid 的 Info API 获取数据进行交叉核对。
- 适用于研究、大模型训练、清算分析、OI 趋势研究和拥挤度检测
- 最好查询
7d或30d等近期时间窗口 - 数据时效性取决于同步覆盖范围,可能存在延迟,并非实时
- 不要将其视为有保障的实时执行数据或精确的历史记账数据
对于 market_recent_candles,请保持请求时间短且近期。MCP 工具会将 1 分钟 K 线响应限制为 720 行(12h),以免 Agent 在单次调用中拉取海量分钟 K 线数据。
AI Agent 如何使用风险工具
这些风险工具旨在帮助 AI 清晰地回答有关市场结构的问题,而不只是倾倒原始数据行。
| 目标 | 最佳工具 | AI 可以回答的问题 |
|---|---|---|
| 检测当前风险 | live_risk_overview、live_coin_risk_snapshot | “目前有哪些脆弱之处?”,“BTC 是否拥挤?”,“哪种币最接近被迫平仓?” |
| 解释近期压力 | live_recent_liquidations、live_liquidation_summary、live_mark_dislocations | “被迫平仓活动发生在哪里?”,“清算前是否出现了基差压力?”,“过去 30 天内清算了哪些仓位?” |
| 追踪市场状态变化 | live_coin_risk_history、live_oi_history、live_cohort_bias_history | “OI 是否随着这波行情持续增长?”,“聪明钱群体是否率先调仓?”,“这种局面如何逐渐变得脆弱?” |
在实践中,Claude 风格的 Agent 可以利用这些工具,将:
- 原始问题:“你怎么看 BTC?”
- 更好的回答:“BTC 的 OI 持续增长,清算增多,聪明钱的偏向减弱,行情后期的基差压力也有所扩大。”
Pulse — 交易员情报
| 工具 | 描述 |
|---|---|
pulse_global_stats | Hyperliquid 上的交易员总数、交易笔数、交易量和 PnL——调用此工具获取当前覆盖范围数据 |
list_markets | 标准化市场发现——列出每个交易对及其 dex、价格、交易量、资金费率和 OI |
pulse_market_overview | list_markets 的已弃用别名(返回相同数据) |
pulse_leaderboard | 按 PnL、胜率、交易量、得分或风险调整后收益排名的顶级交易员 |
pulse_hidden_gems | 大多数平台都忽视的被低估高绩效交易员 |
pulse_most_traded_coins | 按交易量和交易笔数排名的交易最活跃币种 |
pulse_biggest_trades | Hyperliquid 上金额最大的盈利或亏损交易 |
pulse_recent_trades | 过去 N 分钟/小时内金额最大的交易 |
pulse_token_leaderboard | 特定币种的顶级交易员 |
资产 — 跨市场标准目录(v0.6.0)
一个资产,多个交易场所,多个交易代码。由服务端解析同义名称(PAXG↔GOLD、XAUT↔GOLD、XAGT↔SILVER)和交易场所前缀(BTC ≡ flx:BTC ≡ hyna:BTC)。这三项工具都需要 API 密钥。
| 工具 | 描述 |
|---|---|
list_assets | 标准资产目录——按经济敞口对所有资产分组,并列出交易场所、同义名称和跨市场标记。使用 crossMarketOnly: true 可筛选多交易场所资产。 |
list_asset | 查询单个标准资产并查看交易场所明细。接受同义名称——list_asset({canonical: "PAXG"}) 会返回 GOLD 资产。 |
pulse_cross_market_asset | 汇总某一资产在各交易场所的多空持仓、偏向和 OI,并提供跨交易场所的总计及 biasRange 指标(各交易场所对方向看法一致还是存在分歧)。这是 Agent 原生回答“X 是否过度拥挤?”和“各交易场所对 Y 的看法是否存在分歧?”的工具。 |
HIP-4 — 结果合约(v0.7.0)
从 Hyperliquid 索引的预测市场式结果合约。结果侧代币使用 #<encoding>,其中 encoding = 10 * outcomeId + side;侧代币使用 +<encoding>。
Coinversa API 会强制执行后端分级。下文中的“免费”表示仍需要免费 API 密钥。
| 工具 | 套餐 | 输入 | 后端路由 | 返回内容 / 用途 |
|---|---|---|---|---|
hip4_outcomes | 免费 API 密钥 | hours 1-168,默认 24 | GET /hip4/outcomes | 最近活跃的 outcome,包含 outcomeId、可选的问题元数据、解析后的 priceBinary、侧代币、币种键、资产 ID、成交、独立钱包数、名义金额 USDH、首次 / 最近交易时间。用于发现活跃的预测市场。 |
hip4_outcome | 免费 API 密钥 | outcomeId | GET /hip4/outcomes/{outcome_id} | 返回自主网启动以来某个 outcome ID 的详情。返回与发现接口相同的 outcome 结构;若元数据不可用,则包含备用侧代币。 |
hip4_outcome_summary | Starter+ | outcomeId | GET /hip4/outcomes/{outcome_id}/summary | 双侧汇总:侧 0/1 的合约数量、侧名义金额 USDH、名义金额总计、已实现 PnL、成交、独立钱包数、首次 / 最近交易时间。用于回答“这个市场规模有多大?”以及汇总 PnL / 交易量。 |
hip4_outcome_recent_trades | 免费 API 密钥 | outcomeId、hours 1-168,默认 24、limit 1-500,默认 100 | GET /hip4/outcomes/{outcome_id}/recent-trades | 近期真实成交,不包括结算、配对赎回和拍卖阶段的成交。返回交易时间、钱包、coin、sideIndex、侧标签、dirId、价格、数量、PnL 和费用。 |
hip4_questions | 免费 API 密钥 | 无 | GET /hip4/questions | Hyperliquid outcomeMeta 问题目录:问题 ID、名称、描述、备用 outcome、具名 outcome ID、已结算的具名 outcome,以及类别、标的、到期时间、周期和价格阈值等解析后的字段。 |
hip4_recent_settlements | 免费 API 密钥 | hours 1-720,默认 168、limit 1-200,默认 50 | GET /hip4/settlements/recent | 近期结算,包含 outcome ID、结算时间、可判定时的获胜侧、获胜者 / 失败者成交数、获胜者总收益和失败者总亏损。 |
hip4_daily_volume | 免费 API 密钥 | days 1-60,默认 14 | GET /hip4/daily-volume | 自请求截止时间以来的每日变化:成交、独立交易数、独立钱包数、合约数量和名义金额 USDH。用于回答采用率 / 活跃度趋势相关问题。 |
hip4_most_active | 免费 API 密钥 | hours 1-168,默认 24、limit 1-50,默认 10 | GET /hip4/most-active | 按近期成交数排列的热门 outcome;如有可用元数据,则包含元数据和侧代币。用于对当前 outcome 市场活跃度进行排名。 |
hip4_top_traders | Starter+ | days 1-30,默认 7、limit 1-100,默认 25 | GET /hip4/top-traders | Outcome 交易者排行榜:地址、成交、不同 outcome 数量、合约总数、名义金额总计 USDH 和已实现 PnL。 |
hip4_trader_outcomes | Starter+ | address、days 1-365,默认 30 | GET /hip4/trader/{address}/outcomes | 单个钱包的 outcome 历史:outcome ID、侧索引、侧代币、成交、净份额、买入 / 卖出总额 USDH、已实现 PnL、首次 / 最近交易时间。用于钱包级 outcome 尽职调查。 |
hip4_cross_product_overlap | Pro+ | days 1-30,默认 7 | GET /hip4/cross-product/overlap | 统计 HIP-4 outcome 交易者、永续合约交易者、重叠人数和重叠百分比。用于判断 outcome 活动是独立存在,还是与永续合约交易者重合。 |
hip4_perp_position_context | Pro+ | outcomeId、days 1-60,默认 14、limit 1-100,默认 25 | GET /hip4/outcomes/{outcome_id}/perp-position-context | 将当前净持有为正的 outcome 持有者与同一标的上的当前开放永续合约仓位关联起来。返回侧级重叠情况、多空人数、标的净仓位、名义金额、方向一致与对冲人数、仅参与预测的人数,以及带信号标签的头部钱包。用于判断 outcome 交易者是有方向性敞口、进行了对冲,还是仅参与预测。 |
持仓生命周期 — 0.8.0
对于新的 Agent,生命周期工具是首选的持仓级接口。一个生命周期是重建后的单次开仓至平仓持仓,包括加仓、减仓、已实现盈亏、费用、持仓时间和清算状态。只有在明确需要旧版已平仓持仓载荷或全局近期已平仓数据流时,才使用较旧的已平仓持仓工具。
| 目标 | 推荐工具 |
|---|---|
| 快速读取钱包 | pulse_trader_demo |
| 钱包级持仓统计 | pulse_trader_lifecycle_summary |
| 钱包完整生命周期历史 | pulse_trader_lifecycles |
| 深入查看单个持仓的成交记录 | pulse_lifecycle |
| MAE/MFE 风险与退出时机 | pulse_wallet_drawdown_curve、pulse_max_pain_events、pulse_perfect_exits |
| 查找交易者类型 | pulse_survivors、pulse_anti_survivors、pulse_persistent_winners、pulse_capital_titans、pulse_one_month_wonders、pulse_newcomer_whales |
| 全市场生命周期结构 | pulse_coin_alpha_map、pulse_hour_profitability、pulse_market_concentration、pulse_style_distribution |
| 比较钱包 | pulse_compare |
| 分析当前热门群体 | pulse_cohort_recent_positions、pulse_cohort_recent_trades、pulse_cohort_recent_lifecycle_stats、pulse_cohort_recent_top_positions、pulse_cohort_recent_alpha_concentration |
构建方分析 — 0.11.x
构建方(前端、钱包应用、机器人、HIP-3 去中心化交易所)会在 Hyperliquid 按订单收取构建方费用。收入数据准确,来自链上的累计构建方费用账本;交易量、用户和成交明细来自订单到成交的归因,由于尚未归因触发订单(止损/止盈)的成交,因此数据略有低估——每个响应都会附带 dataNotes 说明和 verified 账本区块标记。构建方地址由 0x 加 40 个十六进制字符组成。
| 工具 | 等级 | 说明 |
|---|---|---|
builder_leaderboard | Starter | 按准确的账本收入为构建方排名,并提供归因后的交易量/用户数/成交数及相较上一时段的变化 |
builder_profile | Starter | 单个构建方:收入、每日序列、热门币种、盈利用户占比 |
trader_builders | Starter | 一个钱包交易所使用的所有构建方,按支付费用排序 |
builder_traders | Pro | 某构建方归因到的钱包,包含盈亏、费用、交易量和历史群体等级 |
builder_fills | Pro | 经由某构建方的单笔归因成交(永续/现货/HIP-4) |
builder_cohorts | Pro | 按行为等级划分某构建方的用户群 |
builder_retention | Pro | 最近 12 个月的月度新用户留存三角图 |
builder_overlap | Pro | 哪些其他构建方与该构建方拥有相同的活跃用户 |
builder_journey | Pro | 过去一年获客群体的收入增长:每个钱包的生命周期费用、鲸鱼集中度、达到生命周期收入峰值/50%/75% 所需天数 |
builder_lifecycle | Pro | 按活跃/降温/已切换/休眠/已转移划分整个用户群,并提供真实留存、流失和竞争导致的用户流失情况 |
builder_orders | Pro | 下单层意图:操作和有效期限组合、只减仓占比、止损/止盈触发细分、成交转化率 |
当前隐藏,未计入上述数量: builder_heatmap [Pro]——过去 84 天按 UTC 星期和小时划分的 7×24 网格,显示交易量、费用和成交数。该工具已注册,但默认不予展示,因为在小时汇总数据完成回填前,上游无法在客户端超时限制内响应。设置 COINVERSAA_HIDDEN_TOOLS=(显式设为空)即可将其公布。
Pulse — 交易者档案
| 工具 | 描述 |
|---|---|
pulse_trader_profile | 对任意钱包进行全面尽职调查(PnL、胜率、层级、利润因子) |
pulse_trader_performance | 对比近 30 天与历史累计表现,并显示趋势方向 |
pulse_trader_demo | 快速了解钱包:生命周期摘要,以及近期最大盈利和亏损 |
pulse_trader_trades | 任意钱包的近期交易 — 跟单交易信号 |
pulse_trader_daily_stats | 按日拆分的 PnL、胜率和交易量 |
pulse_trader_token_stats | 按币种拆分的 P&L(发掘交易者的优势所在) |
pulse_trader_lifecycle_summary | 首选的 0.8 钱包仓位摘要 — 盈亏、清算次数、持仓时间、费用、最大盈利/亏损 |
pulse_trader_lifecycles | 首选的 0.8 生命周期历史 — 每行显示一个重建的开仓->平仓仓位 |
pulse_lifecycle | 按 ID 查询单个生命周期,包含组成该生命周期的成交记录 |
pulse_trader_closed_positions | 旧版已平仓仓位数据;进行新的仓位分析时,优先使用 pulse_trader_lifecycles |
pulse_trader_closed_position_stats | 旧版汇总统计;进行新的仓位分析时,优先使用 pulse_trader_lifecycle_summary |
Pulse — 群组分析
每个受追踪的 Hyperliquid 钱包都会按行为划分层级 — 这是其他地方都找不到的独家数据。若要查询当前受追踪的钱包数量,请调用 pulse_global_stats。
PnL 层级(按盈利能力从高到低排列):
| 显示名称 | Slug | 旧版 slug(仍可用) |
|---|---|---|
| Apex | apex | money_printer |
| Sharps | sharps | smart_money |
| Grinders | grinders | grinder |
| Scrapers | scrapers | humble_earner |
| The Crowd | crowd | exit_liquidity |
| Bleeders | bleeders | semi_rekt |
| Trapped | trapped | full_rekt |
| Blown Out | blown_out | giga_rekt |
规模层级(按交易量从大到小排列):
| 显示名称 | Slug | 旧版 slug(仍可用) |
|---|---|---|
| Heavyweights | heavyweights | leviathan |
| Cruiserweights | cruiserweights | tidal_whale |
| Middleweights | middleweights | whale |
| Welterweights | welterweights | small_whale |
| Lightweights | lightweights | apex_predator |
| Featherweights | featherweights | dolphin |
| Flyweights | flyweights | fish |
| Strawweights | strawweights | shrimp |
工具输入接受两种词汇(新 slug 会在 API 调用前进行规范化)。API 响应目前仍会返回旧版 slug(例如 pnlTier: "money_printer")。
| 工具 | 描述 |
|---|---|
pulse_cohort_summary | 所有受追踪钱包的行为层级细分 |
pulse_cohort_positions | Apex / Heavyweights 层级当前持有的仓位 |
pulse_cohort_trades | 群组在过去 N 分钟/小时内进行的所有交易 |
pulse_cohort_history | 任意群组的历史表现趋势 |
pulse_cohort_bias_history | 所有群组的历史逐小时倾向快照 |
pulse_cohort_performance_daily | 所有群组的历史每日表现统计 |
Market — 实时数据
| 工具 | 描述 |
|---|---|
market_price | 任意交易对(原生或 builder dex)的当前标记价格 |
market_positions | 任意钱包的未平仓仓位 |
market_orderbook | 任意交易对的买卖盘深度 |
market_historical_oi | 历史逐小时未平仓合约快照(名义 USD) |
market_recent_candles | 市场近期 1 分钟 K 线,范围最多为最近 12 小时,以确保 MCP 响应内容实用 |
实时 — 实时分析
| 工具 | 描述 |
|---|---|
live_liquidation_heatmap | 不同价格水平上的清算聚集区 — 支撑位/阻力位信号 |
live_risk_overview | 全交易所风险快照:OI、杠杆、仓位拥挤度、临近清算的敞口,以及 7 天清算总额 |
live_coin_risk_snapshot | 当前单币种脆弱性快照:OI、仓位拥挤度、大额仓位、清算热力图,以及 7 天压力情况 |
live_coin_risk_history | 单个币种的多维历史数据:OI、多空情况、群体轮动、K 线、偏离情况和清算流 |
live_mark_dislocations | 单个币种的标记价格/预言机偏离历史 — 有助于在平仓之前或期间发现基差压力 |
live_recent_liquidations | 真实同步器清算事件,包含钱包、币种、罚金和已平仓盈亏 |
live_liquidation_summary | 最全面的清算汇总工具:次数、总额、按币种汇总,以及时间线区间 |
live_long_short_ratio | 全局或单币种多空比,可选历史数据 |
live_cohort_bias | 指定币种每个层级的净多/空立场 |
live_oi_history | 任意币种或全局的历史未平仓量 — 每小时快照,最长 30 天(我们计算的 OI) |
live_official_oi | 官方的各 DEX OI,取自 Hyperliquid 的 Info API(交易场所的真实数据,并非计算得出)— 每小时快照,最长 30 天 |
live_cohort_bias_history | 各群体多空倾向随时间的变化 — 有助于追踪聪明钱轮动 |
pulse_recent_closed_positions | 所有交易者刚刚平仓的仓位,含入场/出场数据 |
示例提示词
连接后,可以尝试向 AI 提问:
- “Hyperliquid 上按盈亏排名前 5 的交易者是谁?”
- “告诉我 apex 层级目前持有哪些仓位”
- “过去 10 分钟内最大几笔交易是什么?”
- “钱包 0x7fda...7d1 在过去一小时内交易了什么?”
- “找出胜率超过 70% 的被低估交易者”
- “深入分析钱包 0x7fda...7d1——它目前的表现还好吗?”
- “BTC 的清算聚集区在哪里?”
- “展示本周 Hyperliquid 的全交易所风险概览”
- “目前哪个币种的仓位拥挤度最高?”
- “展示过去 7 天的 ETH 清算事件”
- “展示 BTC 的风险历史,包括 OI、清算和群体轮动”
- “展示过去 30 天的 BTC 标记价格/预言机偏离情况”
- “聪明钱交易者目前看多还是看空 ETH?”
- “展示过去 24 小时内亏损最大的交易”
- “目前哪些币种交易最活跃?”
- “这位交易者的平均持仓时间和仓位胜率是多少?”
- “xyz DEX 上有哪些市场?”
- “展示所有黄金和白银市场”
- “xyz:GOLD 的价格是多少?”
- “列出所有 builder DEX 市场及其价格”
- “我可以在 Hyperliquid 上交易哪些股票?”
- “展示 BTC 最近 240 根一分钟 K 线”
- “PAXG 和 GOLD 是同一种资产吗?哪些交易场所提供它?”
- “展示所有在 2 个以上 DEX 上交易的资产”
- “目前 BTC 在所有 DEX 上的未平仓量总和是多少?”
- “ETH 在 HYNA 上的仓位拥挤度比在原生 Hyperliquid 上更高吗?”
- “各 DEX 对黄金走势的看法是否一致?”
- “Hyperliquid 自己的 Info API 显示 BTC 的 OI 是多少——和我们的数据一致吗?”
- “今天哪些 HIP-4 结果合约最活跃?”
- “展示结果 123 的近期交易”
- “近期结算了哪些 HIP-4 结果?”
- “本周 HIP-4 结果交易者的排名如何?”
- “对于结果 25,Yes 交易者已经做多 BTC 了吗,还是大多是预测型交易者?”
- “过去 7 天里,结果交易者和永续合约交易者有重合吗?”
环境变量
这些变量适用于本地 stdio 服务(npx -y @coinversaa/[email protected])。托管端点无需配置。
| 变量 | 必填 | 默认值 | 描述 |
|---|---|---|---|
COINVERSAA_API_KEY | 是 | — | 你的 API 密钥(以 cvsa_ 开头)。每个工具都需要此密钥;如果没有此密钥,stdio 服务会在启动时退出。 |
COINVERSAA_API_URL | 否 | https://api.coinversa.ai | 覆盖 API 主机。仅当你运行自己的 Coinversa 后端(可自托管或分支版本)时才需要。 |
速率限制
速率限制根据 API 密钥等级实施:
| 等级 | 每分钟请求数 | 每日上限 | 每月上限 |
|---|---|---|---|
| 免费 API 密钥 | 30 | 1,000 | — |
| Starter | 120 | 2,000 | 50,000 |
| Pro | 600 | 20,000 | 500,000 |
| Enterprise | 自定义 | 自定义 | 自定义 |
每个响应都包含速率限制标头:
X-RateLimit-Limit:你配置的限制X-RateLimit-Remaining:当前窗口内剩余的请求数X-RateLimit-Reset:窗口重置前的秒数X-RateLimit-Tier:你的 API 密钥等级X-RateLimit-Daily-Remaining:今日剩余请求数(适用每日上限时)
开发
此仓库是 npm 包 @coinversaa/mcp-server 的源代码——这是一个 stdio MCP 服务,入口为 src/index.ts → src/coinversaServer.ts 中的 createCoinversaServer()。
git clone https://github.com/coinversaa/mcp-server.git
cd mcp-server
npm install
npm run build
# run the stdio server against your key
COINVERSAA_API_KEY=cvsa_... node build/index.js
# or drive it with the MCP Inspector
npx @modelcontextprotocol/inspector build/index.js
# unit tests (bun) and typecheck
bun test
npx tsc --noEmit
托管 OAuth 连接器 https://mcp.coinversa.ai/mcp 由 Coinversa 运营,并非基于此仓库构建;它提供相同的工具集。
有何不同
这不是对公共区块链 API 的封装。Coinversa 直接索引 Hyperliquid 的清算所,并计算其他地方都不存在的分析数据:
- 规范化的跨市场分类体系:一种资产对应多个场所和多个代码。
list_assets/list_asset/pulse_cross_market_asset可解析同义项(PAXG↔GOLD、XAUT↔GOLD、XAGT↔SILVER),并在服务端汇总各场所的 OI、偏向和仓位,无需客户端分组 - Builder dex 市场:访问 8 个 dex 的 369+ 个市场,涵盖大宗商品、股票、指数和永续合约
- 场所真实 OI:
live_official_oi直接从 Hyperliquid 的 Info API 获取数据,可与我们推导的数据交叉核验 - 行为群体分类:将每个跟踪的钱包划分为 PnL 等级(从 Apex 到 Blown Out)和规模等级(从 Heavyweights 到 Strawweights)
- 实时群体仓位:实时查看优秀交易者持有的仓位
- 实时交易流:可按时间窗口查询任意钱包或群体的每笔交易
- 清算热力图:分析任意币种在不同价格水平上的聚集情况
- 仓位生命周期分析:重建从开仓到平仓的生命周期,提供持仓时长、入场/出场 VWAP、已实现 PnL、手续费、清算状态,以及 MAE/MFE 执行质量分析
- 发掘潜力标的:找到排名网站遗漏的优秀交易者
- 未平仓量历史:获取任意币种最多回溯 30 天的每小时 OI 快照
- 群体偏向历史:跟踪聪明钱、鲸鱼及其他等级的多空仓位随时间的变化
- 最深入的 Hyperliquid 交易历史 API:调用
pulse_global_stats获取实时覆盖数据(而非过时的营销数字)。
贡献
欢迎提交拉取请求。对于重大更改,请先创建 issue,讨论你希望进行的更改。
许可证
由 Coinversa 构建
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。