Kamino Multiply 仓位核对:市场、LTV 小数与借款利息
链小知 · 进阶 · 核验 · 依官方文档整理
读取指定市场的 obligation 记录,把清算阈值、杠杆和净资产按正确单位整理出来。
开始前准备
- 准备 Solana 钱包公开地址、实际 market 地址和已取得的 obligations JSON。
- API/SDK 示例的市场、单位与类型不能自动推广到所有仓位;分析公开地址的记录无需私钥文件。
1. 核对 market 与钱包地址
官方 API 路径为 /kamino-market/{marketAddress}/users/{walletAddress}/obligations。先确认仓位实际所属市场,文档的 xStocks market 只是示例;相同钱包在错误市场返回空数组,不能解释成没有任何仓位。
检查结果:市场和钱包均与目标仓位记录对应。
2. 筛选 Multiply obligation
API 记录检查 humanTag 和 obligationAddress;SDK 按 ObligationTypeTag.Multiply 筛选。Vanilla、Lending 和旧 Leverage 不是同一类仓位,不能把全部 debt 合成一个 Multiply 策略。
检查结果:每条被分析的 obligation 有独立身份和类型。
3. 区分美元金额、倍数与百分比
refreshedStats 的 userTotalDeposit、userTotalBorrow 为价值项,leverage 是倍数。API 示例把 liquidationLtv 乘 100 才显示百分比;SDK 示例已有自己的展示约定,不能对其再照搬乘 100。保留原始值和换算结果。
检查结果:例如 API 0.75 标成 75%,没有变成 7500%。
4. 用净值与阈值做交叉检查
将 Total Deposit − Total Borrow 与净值对照,比较当前 LTV 与该仓位的 liquidationLtv。阈值依资产对与 eMode 而异,不能用官方某一行示例覆盖所有策略。杠杆高低不能替代阈值检查。
检查结果:金额与 LTV 口径可回算,阈值来源具体到仓位。
5. 检查收益为何可能变负
借款利率升高可能超过抵押资产收益;方向性抵押品还受价格下跌影响。缺少当前利率、价格或刷新时点时,保留风险未确认。API 错误与空数组分开处理,RPC/API 访问限额以当前服务为准。
检查结果:输出包含资产对、阈值、净值和数据时点。
怎样确认完成
- 形成逐 obligation 的仓位健康表。
- 空结果、数据过期和收益未知都有明确说明。
常见错误与边界
- 直接使用 xStocks 示例市场查其他仓位。
- 将 SDK 和 API 百分比单位混用。
- 把杠杆策略的展示收益当保证回报。