mcpField
Y
yield-dashboard

yield-dashboard

github.com/aibtcdev其他11136 次安装1 天前更新
代码仓库

关于 yield-dashboard

yield-dashboard 是用于查看 Stacks 协议 DeFi 持仓与收益率的只读命令行技能。它汇总资产价值和 APY，展示各协议持仓，并依据风险调整后的 APY 提供配置建议。

主要功能

  1. 01汇总资产价值与 APY
  2. 02查看协议持仓和奖励
  3. 03列出当前 APY
  4. 04提供风险调整后的再平衡建议
  5. 05读取 Stacks 主网数据

适用场景

  1. 01检查多个支持协议中的持仓
  2. 02比较各协议当前 APY
  3. 03按风险偏好评估配置调整

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill yield-dashboard

安装后在 Claude Code 中输入/yield-dashboard确认已加载。

附带文件AGENT.mdyield-dashboard.ts

详细介绍

Yield 仪表板技能

聚合展示 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 余额读取尚待实现。如果 Bitflow API 不可用，APY 将回退到 2.8% 的估算值（输出包含 apySource: "fallback estimate"）。
  • ALEX 资产：ALEX 池使用的是 aBTC（ALEX 封装 BTC），而非原生 sBTC。两者的信任假设不同——输出中标记为“aBTC/STX LP”。
  • 堆叠价值：STX 堆叠以 microSTX 为单位，而非 sats。overview 命令会将两者分开：totalValueSats（以 BTC 计价）与 totalValueStx（STX 堆叠）。
  • Bitflow API：使用 https://app.bitflow.finance/api——此端点未公开文档，可能会在不另行通知的情况下变更。

备注

  • 所有读取均免费（无需 gas）——使用只读合约调用
  • 必须解锁钱包，以便技能知道要查询哪个地址
  • APY 数值是基于链上状态的时点估算值
  • Bitflow 数据使用 Bitflow 公共 API（无需密钥）
  • 系统会自动探测 Zest V2 是否可用；不可用时回退到 V1 池数据

评论

支持 Markdown