carrydesk

Name: carrydesk
Author: pelazas

本地服务

carry.pelazas.com金融数据09 周前更新

代码仓库访问官网

关于 carrydesk

carrydesk 按小时发布 Hyperliquid 永续合约的资金费率套利排名，提供延迟免费的快照和付费实时数据。它面向分析资金费率差异的交易者与 Agent，并用均值、截尾均值和中位数展示异常值的影响。

主要功能

01按 14 天资金费率排名
02免费延迟前五名快照
03可调 k 值的实时排名
04历史排名与资金费率
05按成交量和 OI 列出合约
06均值、截尾均值和中位数利差

适用场景

01筛选 Hyperliquid 永续合约套利标的
02查看历史资金费率和排名变化
03评估异常值对利差的影响
04获取永续合约市场指标

MCP 相关

MCP 接口提供快照、计算方法、健康状态、排名、历史和市场范围共六种工具。付费工具通过 x402 结算；配置私钥后，Agent 可自动付款。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "pelazas-carrydesk": {
      "command": "uvx",
      "args": [
        "carrydesk"
      ],
      "env": {
        "CARRYDESK_PRIVATE_KEY": "<CARRYDESK_PRIVATE_KEY>",
        "CARRYDESK_API_BASE": "<CARRYDESK_API_BASE>"
      }
    }
  }
}

启动命令uvx carrydesk

需要配置的环境变量

CARRYDESK_PRIVATE_KEY密钥Optional. Private key of a small hot wallet holding USDC on Base, used to pay for the metered tools automatically. Without it the three free tools work normally and the paid tools return their price instead of failing.

CARRYDESK_API_BASEOptional. Override the API base URL. Defaults to https://carry.pelazas.com.

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

安装包

pypicarrydesk0.1.2stdio

工具

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

此工具无需参数。

详细介绍

carrydesk

Hyperliquid 永续合约横截面资金费率套利排名，按次以 USDC 付费。

每小时根据过去 14 天的平均资金费率，对 Hyperliquid 中流动性充足的永续合约进行排名。资金费率最低的币种会向做多者付费；最高的则会向做空者付费。这两条腿之间的价差就是套利收益——一种结构性风险溢价，而非预测。

这与实时市场中性投资组合交易的信号相同，并以 API 形式发布。

端点

	端点	价格
免费	`GET /v1/free/carry` — 每条腿排名前 5，延迟 24 小时	—
免费	`GET /v1/method` — 计算方式及注意事项	—
免费	`GET /health`	—
付费	`GET /v1/carry/rankings` — 完整实时排名，可调整 `k`	$0.05
付费	`GET /v1/carry/history/{coin}` — 历史排名和资金费率	$0.02
付费	`GET /v1/universe` — 按成交量、OI 和资金费率筛选的流动性充足的永续合约	$0.01

付费端点通过 x402 计量收费：服务端返回包含付款要求的 402 响应，客户端在 Base 上支付 USDC、重试，然后获取数据。无需账户、API 密钥或发票。

快速开始

curl -s https://carry.pelazas.com/v1/free/carry | jq

{
  "carry_spread_annualized": 0.3901,
  "carry_spread_annualized_trimmed": 0.2231,
  "carry_spread_annualized_median": 0.0955,
  "headline_vs_typical": 4.09,
  "outlier_dominated": true,
  "longs":  [{"coin": "PENGU", "mean_funding_annualized": -0.0636}, ...],
  "shorts": [{"coin": "SAGA",  "mean_funding_annualized":  1.9886}, ...]
}

始终会返回三个价差数值，以及两个反映它们差距的数值。总体均值表示等权重投资组合的收益；中位数表示典型币种的收益。headline_vs_typical 表示两者的倍数——如上面的示例所示，约为 4，实际通常也在 4 左右；当中位数低于均值的一半时，outlier_dominated 会触发。从上面的结果来看，SAGA 单独就占据了大部分差距——这正是单一数值会掩盖的信息。

MCP

claude mcp add carrydesk -- uvx --from carrydesk carrydesk-mcp

无需克隆仓库或创建虚拟环境——uvx 会获取并运行它。

共六个工具：carry_snapshot、carry_method、carry_health（免费），以及 carry_rankings、carry_history、carry_universe（付费）。默认连接 https://carry.pelazas.com——可通过 CARRYDESK_API_BASE 覆盖。

设置 CARRYDESK_PRIVATE_KEY，即可让 Agent 自动付款。不设置时，免费工具仍可使用，付费工具会返回价格而不是报错，因此没有钱包的安装也仍然有用。

本地开发

uv venv --python 3.12 && uv pip install -e ".[dev]"
.venv/bin/python -m uvicorn carrydesk.api:app --reload   # open, no paywall
.venv/bin/python -m pytest -q                            # full suite, no network

未设置 X402_PAY_TO 时，服务会完全开放运行——这是开发环境的默认设置。设置该变量即可启用付费墙。参见 .env.example。

面向 Agent 和爬虫

/llms.txt 以纯文本介绍整个服务。/openapi.json 是完整规范，/archive 包含曾发布过的所有快照，公开页面还带有 schema.org Dataset 标记。我们明确欢迎爬虫——免费套餐旨在供人阅读、索引和引用。

坦诚说明局限

套利价差可能且确实会变为负值。这是对承受拥挤杠杆风险的补偿，并非预测。
所有数据均为未扣除手续费、滑点和借贷成本的毛收益。仅 taker 手续费就可能抹去收益优势；因此参考投资组合只做 maker。
资金费率采用 Hyperliquid 自身的数据，目前尚未进行跨交易场所对账。
流动性差的币种往往主导总体价差。确定仓位规模前，请先查看截尾值和中位数。
仅供参考，不构成投资建议。

仓库文档

文件	说明
`BACKLOG.md`	刻意延期的工作及各自原因
`AGENTS.md`	为初次接手的 AI Agent 提供的入门指南——注意事项、规则和未经验证的内容
`STATUS.md`	当前状态、受阻事项及后续计划
`DECISIONS.md`	各项重要决策的原因