List all yield opportunities

get

https://api.yield.xyz/v1/yields

Retrieve a paginated list of available yield opportunities across all supported networks and protocols.

Query Params

offset

number

≥ 0

Defaults to 0

Offset for pagination

limit

number

1 to 100

Defaults to 20

Number of items per page

network

string

enum

Filter by network

chainId

string

Filter by EVM chain ID (Ethereum: 1, Polygon: 137)

networks

string

Filter by multiple networks (comma separated)

yieldId

string

length ≤ 200

yieldIds

array of strings

length ≤ 100

yieldIds

type

string

enum

Filter by yield type

types

array of strings

Filter by multiple yield types (comma separated)

types

hasCooldownPeriod

boolean

Filter by cooldown period

hasWarmupPeriod

boolean

Filter by warmup period

token

string

Filter by token symbol or address

inputToken

string

Filter by input token symbol or address

inputTokens

array of strings

Filter by multiple input token symbol or address (comma separated)

inputTokens

provider

string

Filter by provider ID

providers

array of strings

Filter by multiple provider IDs (comma separated)

providers

string

Search by yield name

prime

boolean

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

string

enum

Sort by yield status or reward rate

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Returns a paginated list of yield opportunities

400Invalid request parameters

401Invalid or missing API key

429Rate limit exceeded

500Internal server error