carrydesk

carrydesk

Hyperliquid パーペチュアルのクロスセクション型ファンディング・キャリーランキングを、呼び出しごとに USDC で販売します。

1 時間ごとに、流動性の高い Hyperliquid パーペチュアル銘柄を、過去 14 日間の平均ファンディングでランキングします。最もマイナスの銘柄をロングで保有すると支払いを受け取り、最もプラスの銘柄をショートすると支払いを受け取れます。この 2 つのレッグ間のスプレッドがキャリーです。これは予測ではなく、構造的なリスクプレミアムです。

これは、実際に運用されているマーケットニュートラルのポートフォリオが取引するシグナルと同じものを、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}, ...]
}

スプレッドの数値は常に 3 つあり、それらの差がどれくらいかを示す数値が 2 つあります。見出しの平均値は均等加重ポートフォリオの収益を表し、中央値は典型的な銘柄の支払いを表します。headline_vs_typical は両者の倍率です。上記のサンプルでは約 4 で、実際にもおおむね 4 です。中央値が平均値の半分を下回ると、outlier_dominated が作動します。上記の結果では、SAGA だけで差の大部分を占めています。これは、単一の数値では隠れてしまうまさにその種の特徴です。

---

MCP

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

クローンも仮想環境も不要です。uvx が取得して実行します。

6 つのツールがあります。carry_snapshot、carry_method、carry_health（無料）と、 carry_rankings、carry_history、carry_universe（有料）です。デフォルトでは https://carry.pelazas.com と通信します。CARRYDESK_API_BASE で接続先を変更できます。

エージェントが自動で支払えるようにするには、CARRYDESK_PRIVATE_KEY を設定します。設定しなくても無料ツールは動作し、有料ツールは失敗する代わりに価格を返すため、ウォレットなしのインストールでも役立ちます。

---

ローカル開発

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 を参照してください。

---

エージェントとクローラー向け

/llms.txt にはサービス全体が平易なテキストで記載されています。/openapi.json は完全な仕様書で、/archive にはこれまでに公開されたすべてのスナップショットがあり、公開ページには schema.org の Dataset マークアップがあります。クローラーを明示的に歓迎しています。無料プランは、閲覧、インデックス登録、引用に利用できます。

正直な制約事項

• キャリー・スプレッドはマイナスになることがあり、実際にマイナスになります。これは混雑したレバレッジを引き受けることへの補償であり、予測ではありません。
• すべての数値は手数料、スリッページ、借入コストを差し引く前のものです。テイカー手数料だけで優位性が失われる可能性があるため、参照ポートフォリオはメイカー取引のみを行います。
• ファンディングはHyperliquid 独自のもので、現時点では複数の取引所間での照合を行っていません。
• 流動性の低い銘柄が、ヘッドラインのスプレッドを大きく左右することがよくあります。ポジションサイズを決める前に、トリム平均と中央値も確認してください。
• 情報提供のみを目的としています。投資助言ではありません。

---

リポジトリのドキュメント

ファイル	内容
BACKLOG.md	意図的に先送りした作業と、その理由
AGENTS.md	初めてこのプロジェクトに取り組む AI エージェント向けのオンボーディング情報 — 注意点、ルール、未検証の事項
STATUS.md	現在の状況、阻害要因、次の作業
DECISIONS.md	重要な選択を行った理由