Home / Documentation / Yield Discovery

Yield Discovery

Learn how to discover, analyze, and compare yield opportunities across multiple DeFi protocols and chains using Difract's advanced yield discovery tools.

Overview

Difract's Yield Discovery module helps you identify the most profitable and secure yield opportunities across the DeFi ecosystem. Our platform aggregates data from multiple sources and provides real-time analytics to help you make informed decisions.

Key Features

Real-time APY tracking
Multi-chain support
Protocol risk scoring
Historical yield analysis
Impermanent loss calculator

Supported Protocols

Lending Protocols

Aave
Compound
JustLend
Venus

DEX Liquidity

Uniswap V2/V3
PancakeSwap
Curve Finance
Balancer

Yield Aggregators

Yearn Finance
Beefy Finance
Convex Finance
Harvest Finance

Using the Discovery Tool

Basic Yield Query

const query = await difract.yield.discover({
    asset: "USDC",
    minApy: 5,
    maxRiskScore: 7,
    chains: ["ethereum", "polygon"],
    protocols: ["aave", "compound"]
});

Query Parameters

asset

The token you want to provide as liquidity (e.g., "USDC", "ETH", "BTC")

minApy

Minimum annual percentage yield (APY) requirement

maxRiskScore

Maximum risk score (1-10) you're willing to accept

chains

Array of blockchain networks to search

protocols

Array of specific protocols to include in the search

Advanced Filtering

Difract provides advanced filtering capabilities to help you find the exact yield opportunities that match your investment criteria.

Advanced Filter Example

const opportunities = await difract.yield.discover({
    asset: "ETH",
    minApy: 8,
    maxRiskScore: 6,
    chains: ["ethereum", "optimism"],
    protocols: ["aave", "compound"],
    filters: {
        minTvl: "1000000",  // Minimum TVL in USD
        maxGas: "50",       // Maximum gas in GWEI
        minVolume: "100000" // 24h volume in USD
    },
    sort: {
        by: "apy",
        order: "desc"
    }
});

Risk Metrics

Each yield opportunity comes with comprehensive risk metrics to help you make informed decisions.

Protocol Risk

Smart contract audit status
Time in operation
Previous security incidents
Insurance coverage

Market Risk

Liquidity depth
Volume analysis
Price impact
Volatility metrics

Asset Risk

Token fundamentals
Collateral quality
Historical performance
Correlation analysis

Historical Analysis

Analyze historical yield performance to make better predictions about future returns.

Historical Analysis Example

const history = await difract.yield.getHistory({
    protocol: "aave",
    asset: "USDC",
    chain: "ethereum",
    timeframe: {
        start: "2023-01-01",
        end: "2023-12-31"
    },
    metrics: ["apy", "tvl", "volume"]
});

Yield Comparison

Compare multiple yield opportunities side by side to identify the best option for your portfolio.

Comparison Example

const comparison = await difract.yield.compare({
    opportunities: [
        {
            protocol: "aave",
            asset: "USDC",
            chain: "ethereum"
        },
        {
            protocol: "compound",
            asset: "USDC",
            chain: "polygon"
        }
    ],
    metrics: [
        "apy",
        "tvl",
        "risk_score",
        "gas_costs",
        "impermanent_loss"
    ]
});