List tokens with available yields

get

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

Retrieve tokens that have at least one enabled yield available for this project. Optionally filter by exact token identity, enter/exit availability, networks, and yield types. Returns the full list by default; callers should respect total and use offset/limit, as a default page size may be introduced in future. Maintenance, deprecated, and decommissioned yields are always excluded.

Query Params

address

string

length ≤ 256

Filter by an exact token address. EVM addresses are case-insensitive; case-sensitive network addresses must match exactly.

symbol

string

length ≤ 64

Filter by an exact token symbol (case-insensitive).

enter

boolean

Filter available yields by known enter status. true returns tokens with enterable yields; false returns tokens with yields explicitly marked non-enterable. Missing or malformed status defaults to open. Narrows each token's availableYields; combined with exit using AND.

exit

boolean

Filter available yields by known exit status. true returns tokens with exitable yields; false returns tokens with yields explicitly marked non-exitable. Missing or malformed status defaults to open. Narrows each token's availableYields; combined with enter using AND. Does not surface deprecated yields.

networks

array of strings

Filter by one or more networks. Supports repeated values or comma separated values.

networks

yieldTypes

array of strings

Filter by one or more yield types. Supports repeated values or comma separated values.

yieldTypes

offset

number

≥ 0

Defaults to 0

Offset for pagination

limit

number

≥ 1

Maximum number of items to return. Omit to return the full list.

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 tokens with available enabled yields

400Invalid request parameters

401Invalid or missing API key

429Rate limit exceeded

500Internal server error