yield-dashboard

Yield Dashboard Skill

Stacks DeFi プロトコル全体を横断する、読み取り専用の集約ダッシュボードです。対象は、Zest Protocol（レンディング）、ALEX DEX（AMM LP）、Bitflow（DEX LP）です。ネイティブ STX のステーキング状況も確認します。

すべてのデータは、Hiro API の読み取り専用コントラクト呼び出しを通じて、Stacks メインネットからリアルタイムで取得されます。

使用方法

bun run yield-dashboard/yield-dashboard.ts <subcommand> [options]

サブコマンド

overview

ポートフォリオの概要です。全プロトコルの合計価値、加重平均 APY、プロトコル別の内訳を表示します。

bun run yield-dashboard/yield-dashboard.ts overview

出力：

{
  "totalValueSats": 500000,
  "totalValueBtc": "0.00500000",
  "weightedApyPct": 4.2,
  "protocols": {
    "zest": { "valueSats": 300000, "apyPct": 5.0 },
    "alex": { "valueSats": 150000, "apyPct": 3.5 },
    "bitflow": { "valueSats": 50000, "apyPct": 2.8 },
    "stacking": { "valueSats": 0, "apyPct": 0 }
  },
  "walletSbtcSats": 25000,
  "walletStxMicroStx": 5000000
}

positions

プロトコルごとの詳細なポジションデータです。

bun run yield-dashboard/yield-dashboard.ts positions

プロトコル、資産、数量、現在の APY、報酬情報（ある場合）を含むポジションの配列を返します。

apy-breakdown

サポート対象のすべてのプロトコルの現在の APY 率です。この機能ではウォレットは不要で、純粋な市場データのみを使用します。

bun run yield-dashboard/yield-dashboard.ts apy-breakdown

出力：

{
  "timestamp": "2026-03-06T03:00:00.000Z",
  "rates": [
    { "protocol": "Zest Protocol", "asset": "sBTC", "supplyApyPct": 5.0, "riskScore": 20 },
    { "protocol": "ALEX DEX", "asset": "aBTC/STX LP", "apyPct": 3.5, "riskScore": 50 },
    { "protocol": "Bitflow", "asset": "sBTC", "apyPct": 2.8, "riskScore": 35 },
    { "protocol": "STX Stacking", "asset": "STX", "apyPct": 8.0, "riskScore": 10 }
  ],
  "zestV2Ready": false
}

rebalance

現在のポジションと、リスク調整後 APY に基づく最適な配分を比較し、リバランスの提案を行います。

bun run yield-dashboard/yield-dashboard.ts rebalance [--risk-tolerance low|medium|high]

オプション：

• --risk-tolerance（省略可能、デフォルト：medium）— 配分提案におけるリスク許容度

出力：

{
  "currentAllocation": { "zest": 60, "alex": 30, "bitflow": 10, "stacking": 0 },
  "suggestedAllocation": { "zest": 50, "alex": 20, "bitflow": 10, "stacking": 20 },
  "suggestions": [
    "Consider moving 10% from Zest to STX stacking for diversification",
    "ALEX LP has higher IL risk — reduce if STX/BTC volatility is high"
  ]
}

既知の制限事項

• ALEX LP ポジション：ユーザーの LP トークン残高の読み取りはまだ実装されていません。LP トークンを保有していても、valueSats は 0 と表示されます。APY は正しく読み取られます。
• Bitflow LP ポジション：ALEX と同様、LP 残高の読み取りは TODO です。Bitflow API を利用できない場合、APY は 2.8% の推定値にフォールバックします（出力には apySource: "fallback estimate" が含まれます）。
• ALEX の資産：ALEX プールではネイティブ sBTC ではなく、aBTC（ALEX のラップド BTC）が使用されます。信頼に関する前提が異なるため、出力では「aBTC/STX LP」と表示されます。
• ステーキング価値：STX のステーキング額は sats ではなく microSTX 単位です。overview コマンドでは、totalValueSats（BTC 建て）と totalValueStx（STX のステーキング）を分けて表示します。
• Bitflow API：https://app.bitflow.finance/api を使用します。ドキュメント化されていないエンドポイントのため、予告なく変更される場合があります。

注意事項

• すべての読み取りは無料で、ガスは不要です。読み取り専用のコントラクト呼び出しを使用します。
• スキルが照会するアドレスを認識できるよう、ウォレットのロックを解除しておく必要があります。
• APY の数値は、オンチェーンの状態に基づく特定時点での推定値です。
• Bitflow のデータには Bitflow の公開 API を使用します（キー不要）。
• Zest V2 の利用可否は自動的に確認され、利用できない場合は V1 プールデータにフォールバックします。