Web3 Investor

Your AI-powered DeFi research analyst. Not a dashboard — a thinker.

Web3 Investor turns vague investment intent into structured, risk-aware recommendations. It doesn't just fetch APY data — it understands what you're looking for, scores every opportunity across 7 risk dimensions, cross-references smart money flows, scans for contract vulnerabilities, and explains its reasoning in plain English.

---

The Problem It Solves

DeFi yield farming today looks like this:

1. 1. Open DeFiLlama → see 2,500+ pools → overwhelming
2. Check audits, TVL, APY trend, IL risk — each on a different site
3. Cross-reference with Twitter sentiment and whale wallets
4. Try to figure out if the yield is sustainable or just emission bait
5. Give up and put money in USDC savings at 4%

Web3 Investor collapses this into one natural-language request:

CODEBLOCK0

---

🧠 How It Works

The Intelligence Pipeline

CODEBLOCK1

---

🛠 Three Tools. Deep Intelligence.

investor_discover — Find Opportunities

The entry point. Converts natural language into structured intent, discovers opportunities, and returns ranked recommendations.

What makes it different from a simple DeFiLlama query:

Feature	DeFiLlama	investor_discover
Input	Chain + sort	Natural language ("stablecoin, conservative")
Intent understanding

None | Keyword + LLM fusion with 95%+ accuracy |
| Risk filtering | Manual | Automatic 7-dimension scoring + threshold |
| Multi-round | N/A | Session-based intent accumulation |
| Clarification | N/A | Asks focused questions when intent is ambiguous |
| Smart money | N/A | Integrated whale flow signals |
| DeFi security | N/A | AI contract scanner per pool |
| Explanation | N/A | "Why this?" reasoning per recommendation |

Multi-round Session Example:
CODEBLOCK2

Request:
CODEBLOCK3

Response highlights:

{
  "gate_status": "PASS",
  "recommendations": [{
    "name": "Aave V3 USDC",
    "yield": { "apy": 5.2, "apy_base": 2.8, "apy_reward": 2.4 },
    "scale": { "tvl_usd": 1500000000 },
    "risk": {
      "risk_level": "LOW",
      "risk_score": 82,
      "risk_factors": { "tvl_score": 95, "audit_score": 90, ... },
      "warnings": []
    },
    "data_quality": { "score": 95, "level": "HIGH", "cross_validated": true },
    "incentive": { "score": "medium", "reward_ratio": 0.46 },
    "smart_money": { "flow": "inflow", "sentiment_score": 0.72, "confidence": "high" },
    "explanation": {
      "summary": "Aave V3 USDC: 5.2% APY, TVL $1.5B",
      "reasons": { "for": [...], "against": [...] },
      "compared_to": { "benchmark": "US bank savings (4.0%)", "outperformance": "1.3x" },
      "risks": { "controllable": ["随时可赎回"], "uncontrollable": ["智能合约风险"] }
    }
  }],
  "search_stats": {
    "total_candidates": 247,
    "total_after_risk_filter": 89,
    "final_recommendations": 5,
    "filters_applied": ["defillama_fetch:ethereum", "intent_filter:STABLECOIN", "risk_scoring", "dust_filter:50000"]
  }
}

---

investor_analyze — Deep Analysis

LLM-powered 5-step reasoning chain for a single product. Goes beyond numbers to provide understanding.

Analysis depths:

Depth	What You Get	Use Case
INLINECODE2	Key metrics + risk score + 1-paragraph summary	Quick check
INLINECODE3

Full risk breakdown + yield source analysis + sustainability assessment + smart money + historical APY | Recommended for investment decisions |
| full | Everything in detailed + peer comparison + protocol profile + governance analysis + LLM narrative | Due diligence |

The LLM analysis covers:

CODEBLOCK5

---

investor_compare — Side-by-Side Comparison

Compare 2–5 products with LLM-powered interpretation across customizable dimensions.

Default comparison dimensions: APY, risk score, TVL

Extended dimensions: fees, lock period, audit count, IL risk, governance type, smart money sentiment, incentive sustainability

LLM comparison output:

{
  "llm_comparison": {
    "narrative": "Aave offers superior security with $1.5B TVL and 6 audits, while Compound provides higher raw yield at 6.1% but with smaller TVL...",
    "risk_comparison": "Aave's risk score (82) significantly outperforms Compound (68), primarily due to larger TVL and more comprehensive audit coverage",
    "recommendation_with_reasoning": {
      "for_conservative": "Choose Aave — battle-tested protocol, deep liquidity, multiple top-tier audits",
      "for_aggressive": "Consider Compound — 0.9% higher APY, acceptable risk for short-term positions",
      "key_tradeoff": "0.9% yield premium vs significantly lower risk score (82 vs 68)"
    }
  }
}

---

🏗️ Server-Side Architecture

CODEBLOCK7

---

🔐 Risk Intelligence

7-Dimension Risk Scoring

Each opportunity is scored 0–100 across seven independent dimensions:

Dimension	What It Measures	Weight
TVL Score	Total Value Locked — protocol maturity indicator	High
Audit Score

Number and quality of security audits | High |
| Chain Score | Chain maturity (L1 vs L2 vs new chain) | Medium |
| Sustainability | Yield source analysis (fees vs emissions) | High |
| Deposit Token | Safety tier of the deposit asset (USDC > DAI > random) | Medium |
| Reward Token | Liquidity and safety of reward tokens | Low |
| Protocol Trust | Governance, longevity, track record | Medium |

Risk Levels:

• - LOW (score ≥ 70): Battle-tested, well-audited, high TVL
• MEDIUM (score 50–69): Established but with some risk factors
• HIGH (score 30–49): Newer or with significant warnings
• VERY_HIGH (score < 30): Experimental or flagged

DeFi Security Scanning

Every pool is scanned by an AI-powered contract security engine:

CODEBLOCK8

Smart Money Sentiment

Real-time whale and fund wallet activity aggregated from Dune Analytics:

CODEBLOCK9

Market Context Awareness

The engine is aware of the current market cycle (bull/bear/sideways), total DeFi TVL, BTC dominance, and US Treasury rates — providing context-aware recommendations that adjust for macro conditions.

---

🚀 Quick Start

Prerequisites

• - Python 3.8+
• No API keys needed — all intelligence runs server-side

Registration (one-time)

CODEBLOCK10

Usage

CODEBLOCK11

---

⚠️ Critical Rules

Rule 1: Discovery First

Never give generic investment advice without real-time data. CODEBLOCK12

Rule 2: Explain Your Reasoning

Every recommendation should include the explanation object — summary, reasons for/against, benchmark comparison, risk classification.

Rule 3: Risk Is Non-Negotiable

• - APY data may be delayed — always show data_quality.score and INLINECODE8
• Never recommend VERY_HIGH risk products without explicit user acknowledgment
• Investment decisions are the user's own responsibility — always DYOR

Rule 4: Honest About Limitations

• - If no good options exist for the user's criteria, say so with INLINECODE9
• Show alternatives even if they don't perfectly match — "This is close but has X tradeoff"

---

🔒 Security

Layer	Protection
Private Keys	Zero contact — never held, transmitted, or stored
Data Sources

Triple-validated (DefiLlama + Dune + CoinGecko) with cross-source checks | | Contract Safety | AI-powered DeFi security scanner on every pool | | Risk Scoring | 7 independent dimensions, no single point of failure | | Scam Detection | Automated flagging via DeFi Security engine (isScam check) | | Data Quality | Freshness tracking, confidence scores, validation issue logging |

---

📝 Changelog

v3.8.0 (2026-04-14)

• - Full SKILL.md rewrite — English, feature-focused, comprehensive
• Documented complete server-side intelligence pipeline
• Added 7-dimension risk scoring documentation
• Added DeFi Security scanning documentation
• Added Smart Money sentiment documentation
• Added Market Context awareness documentation
• Added multi-round session intent accumulation flow
• Added honest "no result" explanation behavior
• Added incentive sustainability scoring documentation
• Added data quality cross-validation documentation

v3.7.2 (2026-04-13)

• - Client cleanup: removed deprecated tools (feedback/confirm-intent/get-intent)

---

🤝 Contributing

Test donations welcome:

• - Network: Base Chain
• Address: INLINECODE11

---

Maintainer: Web3 Investor Skill Team
Registry: https://clawhub.com/skills/web3-investor
License: MIT