Discovery
List all yield opportunities
Retrieve a paginated list of available yield opportunities across all supported networks and protocols.
get/v1/yields
Request
- Base URL: https://api.yield.xyz
- URL: https://api.yield.xyz/v1/yields
- Auth: API key in header x-api-key
Query parameters
offsetnumber
Offset for pagination
limitnumber
Example:20
Number of items per page
network'ethereum' | 'ethereum-goerli' | 'ethereum-holesky' | 'ethereum-sepolia' | 'ethereum-hoodi' | 'arbitrum' | 'base' | 'base-sepolia' | 'gnosis' | 'optimism' | 'polygon' | 'polygon-amoy' | 'starknet' | 'zksync' | 'linea' | 'unichain' | 'plume' | 'monad-testnet' | 'monad' | 'robinhood' | 'robinhood-testnet' | 'arc-testnet' | 'arc' | 'avalanche-c' | 'avalanche-c-atomic' | 'avalanche-p' | 'binance' | 'celo' | 'fantom' | 'harmony' | 'moonriver' | 'okc' | 'viction' | 'core' | 'sonic' | 'plasma' | 'katana' | 'hyperevm' | 'tempo' | 'pharos' | 'xlayer' | 'agoric' | 'akash' | 'axelar' | 'band-protocol' | 'bitsong' | 'canto' | 'chihuahua' | 'comdex' | 'coreum' | 'cosmos' | 'crescent' | 'cronos' | 'cudos' | 'desmos' | 'dydx' | 'evmos' | 'fetch-ai' | 'gravity-bridge' | 'injective' | 'irisnet' | 'juno' | 'kava' | 'ki-network' | 'mars-protocol' | 'nym' | 'okex-chain' | 'onomy' | 'osmosis' | 'persistence' | 'quicksilver' | 'regen' | 'secret' | 'sentinel' | 'sommelier' | 'stafi' | 'stargaze' | 'stride' | 'teritori' | 'tgrade' | 'umee' | 'sei' | 'mantra' | 'celestia' | 'saga' | 'zetachain' | 'dymension' | 'humansai' | 'neutron' | 'polkadot' | 'kusama' | 'westend' | 'bittensor' | 'aptos' | 'binancebeacon' | 'cardano' | 'near' | 'solana' | 'solana-devnet' | 'stellar' | 'stellar-testnet' | 'sui' | 'tezos' | 'tron' | 'ton' | 'ton-testnet' | 'hyperliquid'
Filter by network
chainIdstring
Example:1
Filter by EVM chain ID (Ethereum: 1, Polygon: 137)
networksstring
Filter by multiple networks (comma separated)
yieldIdstring
Example:optimism-usdt-aave-v3-lending
yieldIdsstring[]
[ "optimism-usdt-aave-v3-lending" ]
type'staking' | 'restaking' | 'lending' | 'vault' | 'fixed_yield' | 'real_world_asset' | 'concentrated_liquidity_pool' | 'liquidity_pool' | 'liquid_staking'
Filter by yield type
typesstring[]
Filter by multiple yield types (comma separated)
hasCooldownPeriodboolean
Example:true
Filter by cooldown period
hasWarmupPeriodboolean
Example:true
Filter by warmup period
tokenstring
Filter by token symbol or address
inputTokenstring
Filter by input token symbol or address
inputTokensstring[]
Filter by multiple input token symbol or address (comma separated)
providerstring
Filter by provider ID
providersstring[]
Filter by multiple provider IDs (comma separated)
searchstring
Search by yield name
primeboolean
Example:true
Filter by the Prime quality flag. true returns only Prime yields; false returns only non-Prime yields; omitting the parameter returns the full catalog. Composable with all other filters.
sort'statusEnterAsc' | 'statusEnterDesc' | 'statusExitAsc' | 'statusExitDesc' | 'rewardRateAsc' | 'rewardRateDesc'
Sort by yield status or reward rate
Response
Returns a paginated list of yield opportunities
Example response
{
"total": 100,
"limit": 20,
"items": [
{
"id": "ethereum-eth-lido-staking",
"chainId": "1",
"inputTokens": [
{
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
}
],
"outputToken": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
},
"token": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
},
"tokens": [
{
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
}
],
"rewardRate": {
"total": 6.5,
"rateType": "APR",
"components": [
{
"rate": 0.04,
"rateType": "APR",
"token": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
},
"yieldSource": "protocol_incentive",
"description": "LDO distributed to incentivize stETH adoption via Lido Boost"
}
]
},
"feeConfigurations": [
{
"id": "66f299cd-aaaa-bbbb-cccc-d1f26e3a02db",
"default": true,
"statistics": {
"tvlUsd": "1,200,000",
"tvl": "500.25",
"tvlRaw": "500250000000000000000",
"uniqueUsers": 348,
"averagePositionSizeUsd": "3,448.27",
"averagePositionSize": "1.44"
}
}
],
"statistics": {
"tvlUsd": "1,200,000",
"tvl": "500.25",
"tvlRaw": "500250000000000000000",
"uniqueUsers": 348,
"averagePositionSizeUsd": "3,448.27",
"averagePositionSize": "1.44"
},
"risk": {
"ratings": [
{
"rating": "AA",
"source": "credora"
}
]
},
"status": {
"enter": true,
"exit": true
},
"metadata": {
"name": "Lido Staking",
"logoURI": "https://lido.fi/logo.png",
"description": "Stake ETH with Lido to earn auto-compounding validator rewards via stETH.",
"documentation": "https://docs.lido.fi",
"supportsCampaigns": true
},
"mechanics": {
"requiresValidatorSelection": true,
"gasFeeToken": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
},
"lockupPeriod": {
"seconds": 86400
},
"cooldownPeriod": {
"seconds": 86400
},
"warmupPeriod": {
"seconds": 86400
},
"fee": {
"deposit": "0.00",
"withdrawal": "0.00",
"management": "2.00",
"performance": "20.00"
},
"entryLimits": {
"minimum": "0.01",
"maximum": "1000.0",
"subsequentMinimum": "10000"
},
"requirements": {
"kyc": {
"kycMode": "oauth_redirect",
"eligibility": {
"defaultPolicy": "deny",
"countries": [
"US"
],
"blockedCountries": [
"US",
"CA",
"CN"
],
"blockedSubdivisions": [
"UA-43",
"UA-14"
],
"investorEligibility": [
{
"jurisdiction": "US",
"tier": "us_qualified_purchaser",
"verificationLevel": "third_party_attestation",
"expiresAfterDays": 90
}
],
"subjectTypes": [
"KYC",
"KYB"
]
},
"selfAttestation": {
"documents": [
{
"name": "Risk Disclosures"
}
]
}
}
},
"arguments": {
"enter": {
"fields": [
{
"name": "amount",
"type": "string",
"label": "Amount to Enter",
"required": true,
"options": [
"individual",
"batched"
],
"optionsRef": "/api/v1/validators?integrationId=eth-lido",
"minimum": "1.0",
"maximum": "100.0"
}
]
},
"exit": {
"fields": [
{
"name": "amount",
"type": "string",
"label": "Amount to Enter",
"required": true,
"options": [
"individual",
"batched"
],
"optionsRef": "/api/v1/validators?integrationId=eth-lido",
"minimum": "1.0",
"maximum": "100.0"
}
]
},
"balance": {
"fields": [
{
"name": "amount",
"type": "string",
"label": "Amount to Enter",
"required": true,
"options": [
"individual",
"batched"
],
"optionsRef": "/api/v1/validators?integrationId=eth-lido",
"minimum": "1.0",
"maximum": "100.0"
}
]
}
}
},
"providerId": "lido",
"tags": [
"restaking",
"ETH",
"LST"
],
"state": {
"pricePerShareState": {
"price": 1.05,
"shareToken": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
},
"quoteToken": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
}
},
"concentratedLiquidityPoolState": {
"baseApr": 0.12,
"price": 3950.42,
"tickSpacing": 50,
"minTick": -887272,
"maxTick": 887272,
"volume24hUsd": 149550871.99,
"fee24hUsd": 14955.09,
"tvlUsd": 9213550.2,
"feeTier": 0.0005,
"baseToken": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
},
"quoteToken": {
"symbol": "ETH",
"name": "Ethereum",
"decimals": 18,
"network": "Ethereum",
"address": "0x...",
"logoURI": "https://...",
"isPoints": true,
"coinGeckoId": "ethereum"
}
},
"allocations": [
{
"address": "0x1234567890abcdef1234567890abcdef12345678",
"network": "base",
"name": "Morpho Moonwell USDC",
"yieldId": "base-usdc-morpho-moonwell-usdc",
"providerId": "morpho",
"allocation": "50000.00",
"allocationUsd": "50000.00",
"weight": 50.5,
"targetWeight": 50,
"rewardRate": {
"total": 5.25,
"rateType": "APY"
},
"tvl": "500.25",
"tvlUsd": "10000000.00",
"maxCapacity": "1000000.00",
"remainingCapacity": "500000.00"
}
]
},
"investmentSchedule": {
"timezone": "America/New_York",
"subscription": {
"paths": [
{
"cutoffTime": "16:00",
"currentWindow": {
"opensAt": "2026-07-21T08:00:00Z",
"closesAt": "2026-07-27T20:00:00Z"
},
"nextWindow": {
"opensAt": "2026-07-21T08:00:00Z",
"closesAt": "2026-07-27T20:00:00Z"
},
"settlement": {
"marketDays": 1,
"estimatedDuration": {
"seconds": 86400
},
"instantPortion": 0.93
},
"accrual": {
"minimumHold": {
"seconds": 86400
}
},
"limits": {
"maxFractionOfNav": 0.05,
"availableLiquidity": "323155"
},
"fee": {
"rate": 0.0007
}
}
]
},
"redemption": {
"paths": [
{
"cutoffTime": "16:00",
"currentWindow": {
"opensAt": "2026-07-21T08:00:00Z",
"closesAt": "2026-07-27T20:00:00Z"
},
"nextWindow": {
"opensAt": "2026-07-21T08:00:00Z",
"closesAt": "2026-07-27T20:00:00Z"
},
"settlement": {
"marketDays": 1,
"estimatedDuration": {
"seconds": 86400
},
"instantPortion": 0.93
},
"accrual": {
"minimumHold": {
"seconds": 86400
}
},
"limits": {
"maxFractionOfNav": 0.05,
"availableLiquidity": "323155"
},
"fee": {
"rate": 0.0007
}
}
]
}
},
"executionContracts": {
"enter": [
"0x16D5A408e807db8eF7c578279BEeEe6b228f1c1C"
],
"exit": [
"0xae78736Cd615f374D3085123A210448E74Fc6393",
"0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE"
]
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.