跳转到主要内容
Coming Soon - 此功能正在开发中,敬请期待!
本文档介绍如何使用 ChainStream 监控 DeFi 协议活动,包括流动性变化、大额交易、收益追踪和风险告警。

支持的 DeFi 协议

DEX(去中心化交易所)

协议支持功能
Uniswap V2/V3Ethereum, Polygon, Arbitrum, Base交易、LP、池子数据
PancakeSwapBSC交易、LP、池子数据
SushiSwapMulti-chain交易、LP
RaydiumSolana交易、LP
JupiterSolana聚合交易
CurveEthereum, Multi-chain稳定币交易、LP

借贷协议

协议支持功能
Aave V3Ethereum, Polygon, Arbitrum借贷、清算、利率
Compound V3Ethereum, Base借贷、清算
VenusBSC借贷、清算
MorphoEthereum借贷优化

收益聚合器

协议支持功能
Yearn FinanceEthereumVault 策略、收益
Convex FinanceEthereumCurve LP 增强
Beefy FinanceMulti-chain自动复投

流动性质押

协议支持功能
LidoEthereumETH 质押
Rocket PoolEthereumETH 质押
MarinadeSolanaSOL 质押

监控维度

1. 流动性监控

监控事件

事件描述重要性
pool_created新池子创建发现新机会
liquidity_add添加流动性信心指标
liquidity_remove移除流动性⚠️ 撤池预警
pool_update池子参数变更协议治理

关键指标

指标描述健康标准
TVL总锁仓价值稳定或增长
TVL 变化率24h/7d TVL 变化> -10%/天
LP 持有者数LP Token 持有者分布分散为佳
流动性深度±2% 价格范围内的流动性深度越大越好

撤池风险信号

  • 单笔撤池 > 池子 30%
  • 24h 累计撤池 > 50%
  • LP 集中在少数地址(< 5 个)

2. 交易监控

实时交易流

通过 WebSocket 订阅实时交易:
事件类型描述数据字段
swapDEX 交易token_in, token_out, amount, price
large_trade大额交易threshold, trade_details
arbitrage套利交易profit, path
mevMEV 相关交易type, extracted_value
// 订阅 DEX 交易流
ws.subscribe('defi_trades', {
  protocol: 'uniswap_v3',
  chain: 'ethereum',
  min_amount_usd: 10000
}, (trade) => {
  console.log(`${trade.type}: ${trade.token_in}${trade.token_out}`);
});

交易分析维度

分析维度指标意义
买卖压力买入量/卖出量比率> 1 看涨
交易量趋势交易量移动平均活跃度
大户行为大额交易占比市场影响
交易对热度交易频率排名市场关注度

3. 收益追踪

追踪内容

收益类型描述计算方式
LP 挖矿提供流动性获得的交易费交易费 × 份额占比
借贷利息存款/借款利息本金 × APY
质押奖励协议代币奖励质押量 × 奖励率
空投收益协议空投快照持仓

收益指标

指标描述注意事项
APY年化收益率(含复利)实际收益参考
APR年化收益率(不含复利)基础收益
无常损失LP 相对于持有的损失重要风险因素
净收益收益 - Gas - 无常损失最终收益

无常损失估算

无常损失公式
无常损失 = 2 × √(价格比率) / (1 + 价格比率) - 1
价格变化无常损失
±10%-0.11%
±25%-0.64%
±50%-2.02%
±100%-5.72%
±200%-13.4%

4. 风险告警

协议级风险

风险类型描述告警触发
大额撤池流动性大幅减少单笔 > 池子 5%
TVL 骤降协议 TVL 快速下降1h 内下降 > 20%
闪电贷攻击检测到闪电贷模式自动检测
治理攻击异常提案或投票自动检测
预言机异常价格数据异常偏离 > 5%

头寸级风险

风险类型描述告警触发
清算风险借贷头寸接近清算健康因子 < 1.2
无常损失LP 无常损失扩大损失 > 5%
收益下降APY 大幅下降下降 > 50%

告警配置示例

{
  "alert_type": "liquidity_remove",
  "protocol": "uniswap_v3",
  "pool": "0x...",
  "threshold": {
    "type": "percentage",
    "value": 10
  },
  "notification": {
    "webhook": "https://your-server.com/webhook",
    "email": "alert@example.com"
  }
}

监控场景

场景 1:新池子发现

目标:第一时间发现新建的交易池
ws.subscribe('pool_created', {
  chain: 'ethereum',
  min_liquidity_usd: 10000
}, async (pool) => {
  // 检查 Token 安全性
  const risk = await checkTokenRisk(pool.token_address);
  if (risk.score > 60) {
    notify(`新池子发现: ${pool.pair_name}, 流动性: $${pool.liquidity_usd}`);
  }
});

场景 2:撤池预警

目标:监控持仓池子的撤池风险
1

添加监控

添加目标池子到监控列表
2

设置阈值

设置撤池阈值(如单笔 > 10%)
3

接收告警

接收实时告警
4

调整持仓

及时调整持仓
ws.subscribe('liquidity_remove', {
  pool: '0x...',
  threshold_percentage: 10
}, (event) => {
  alert(`⚠️ 撤池预警: ${event.percentage}% 流动性被移除`);
});

场景 3:套利机会发现

目标:发现跨 DEX 价格差异
1

订阅价格流

订阅多个 DEX 的价格流
2

计算价差

计算价差百分比
3

成本评估

考虑 Gas 和滑点成本
4

发送告警

当净利润 > 阈值时告警
// 监听多个 DEX 的价格
const prices = {};

ws.subscribe('token_price', { 
  token: 'WETH',
  dex: ['uniswap', 'sushiswap', 'curve']
}, (data) => {
  prices[data.dex] = data.price;
  checkArbitrage(prices);
});

function checkArbitrage(prices) {
  const maxPrice = Math.max(...Object.values(prices));
  const minPrice = Math.min(...Object.values(prices));
  const spread = (maxPrice - minPrice) / minPrice;
  
  if (spread > 0.005) {  // 0.5% 价差
    notify(`套利机会: ${spread * 100}% 价差`);
  }
}

场景 4:清算监控

目标:监控借贷头寸健康度
1

获取头寸

获取目标地址的借贷头寸
2

计算健康因子

计算实时健康因子
3

预警

当健康因子 < 1.5 时预警
4

紧急告警

当健康因子 < 1.2 时紧急告警
async function monitorLiquidationRisk(address: string) {
  const position = await getDefiPosition(address, 'aave_v3');
  
  if (position.health_factor < 1.2) {
    urgentAlert(`🚨 清算风险!健康因子: ${position.health_factor}`);
  } else if (position.health_factor < 1.5) {
    warnAlert(`⚠️ 健康因子较低: ${position.health_factor}`);
  }
}

数据延迟说明

数据类型延迟说明
实时交易< 3s区块确认后推送
TVL 数据< 1min分钟级更新
APY 数据< 5min基于最近交易计算
持有者数据< 1h小时级快照

API 端点

功能端点
获取协议 TVLGET /v1/defi/{protocol}/tvl
获取池子信息GET /v1/defi/{protocol}/pools/{pool_id}
获取用户头寸GET /v1/defi/{protocol}/positions/{address}
获取收益数据GET /v1/defi/{protocol}/yields

相关文档