yield-shark

# 🦈 YieldShark - DeFi Yield Shark

**Smell the Money** - Hunt for the highest APY in the DeFi ocean!

## Overview

YieldShark monitors real-time stablecoin yields across 50+ DeFi platforms including Aave, Compound, Curve, Uniswap, Yearn, Beefy, and more. Get data-driven insights for your crypto investments.

## Features

- **Real-time Data**: Direct integration with DeFiLlama API (free, public)
- **Multi-Token Support**: USDT, USDC, DAI
- **Multi-Chain**: Ethereum, Arbitrum, Optimism, Base, Polygon, BSC
- **Smart Filtering**: Excludes LP pools, filters APY outliers (<30%), TVL >$100k
- **Risk Ratings**: A-E safety scores based on audits and insurance
- **Gas Estimation**: Calculate net APY after transaction costs
- **Platform Comparison**: Side-by-side analysis of top protocols

## Installation

```bash
clawhub install yield-shark
```

## Usage

### Quick Start

```bash
# Query USDT yields
node scripts/monitor.mjs USDT

# Query USDC with custom limit
node scripts/monitor.mjs USDC --limit 10

# Query DAI on specific chain
node scripts/monitor.mjs DAI --chain ethereum
```

### All Scripts

```bash
# Monitor yields
node scripts/monitor.mjs USDT

# Compare platforms
node scripts/compare.mjs --token USDT

# Calculate net APY
node scripts/calculate.mjs --amount 5000 --platform compound

# Set yield alerts
node scripts/alert.mjs --apy 5

# Generate report
node scripts/report.mjs --format markdown
```

### NPM Commands

```bash
npm run monitor    # Run monitor script
npm run compare    # Compare platforms
npm run test:usdt  # Test USDT query
npm run test:usdc  # Test USDC query
npm run test:dai   # Test DAI query
```

## Output Example

```
💰 USDT 最优收益排行 (DeFiLlama 实时数据)

排名  平台 (链)            APY      风险    Gas     TVL
──────────────────────────────────────────────────────────────────────
🥇 Compound V3  (Optimism)   3.5%     🟢 A+    $0.3   $1M
🥈 Beefy        (Optimism)   3.4%     🟡 B+    $0.3   $1M
🥉 Compound V3  (Polygon)    2.9%     🟢 A+    $0.5...

# 🦈 YieldShark

**DeFi Yield Optimization Platform** - Find the highest APY for your stablecoins!

[![Version](https://img.shields.io/github/v/release/gztanht/yield-shark)](https://github.com/gztanht/yield-shark/releases)
[![License](https://img.shields.io/github/license/gztanht/yield-shark)](LICENSE)
[![ClawHub](https://img.shields.io/badge/ClawHub-yield--shark-blue)](https://clawhub.com/skills/yield-shark)

> **Smell the Money** - In the vast ocean of DeFi, be a shark hunting for the highest yields! 🦈

---

## 🌟 Features

- **Real-Time APY Tracking** - Live data from 50+ DeFi platforms via DeFiLlama API
- **Multi-Token Support** - USDT, USDC, DAI stablecoin monitoring
- **Multi-Chain** - Ethereum, Arbitrum, Optimism, Base, Polygon, BSC, Monad
- **Smart Filtering** - Excludes LP pools, filters outliers, TVL > $100k
- **Net APY Calculator** - Accounts for gas fees
- **Yield Alerts** - Get notified when APY hits your target
- **Platform Comparison** - Side-by-side analysis

---

## 🚀 Quick Start

```bash
# Install
npx @gztanht/yield-shark

# Check USDT yields
node scripts/monitor.mjs USDT

# Compare multiple tokens
node scripts/compare-tokens.mjs

# Calculate net APY (after gas)
node scripts/calculate.mjs --amount 10000

# Get yield optimization suggestions
node scripts/optimize.mjs --token USDT --amount 10000
```

---

## 📊 Example Output

```bash
$ node scripts/monitor.mjs USDT

💰 USDT Top Yields (DeFiLlama Live Data)

Rank  Platform (Chain)       APY     Risk   TVL
─────────────────────────────────────────────────────
1     merkl (Hyperliquid)   61.68%   B      $5M
2     morpho (Arbitrum)     24.39%   B      $3M
3     aave-v3 (Optimism)    3.50%    A+     $100M

💡 Smart Pick: merkl (Hyperliquid) - Best risk-adjusted APY
```

---

## 💰 Pricing - Free First!

| Plan | Price | Limit |
|------|-------|-------|
| **Free** | $0 | **5 queries/day** |
| **Sponsor Unlock** | 0.5 USDT or 0.5 USDC | Unlimited |

> 💡 Feel free to sponsor more if you find it useful!...