List tokens

List tokens that have at least one enabled yield for your project, with yield availability per token.

GET /v1/tokens

List tokens with available yields

cURL

curl --request GET \
  --url https://api.yield.xyz/v1/tokens \
  --header 'x-api-key: <api-key>'

200

{
  "total": 100,
  "offset": 0,
  "limit": 20,
  "items": [
    {
      "token": {
        "symbol": "ETH",
        "name": "Ethereum",
        "decimals": 18,
        "network": "Ethereum",
        "address": "0x...",
        "logoURI": "https://...",
        "isPoints": true,
        "coinGeckoId": "ethereum"
      },
      "availableYields": [
        "<string>"
      ]
    }
  ]
}

Project-scoped. Maintenance, deprecated and decommissioned yields are excluded. networks and yieldTypes accept repeated values or one comma-separated string. address matches an exact token address and symbol an exact symbol.

enter and exit narrow each token’s availableYields, not only the token list. With no limit, the full list is returned: read total and page with offset and limit. Yield type values are in Yield types.

Authorizations

x-api-key · string · header · required

Query Parameters

address · string

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

Maximum string length: 256

symbol · string

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

Maximum string length: 64

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 · enum<string>[]

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

Available options: 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, 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

yieldTypes · enum<string>[]

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

Available options: staking, restaking, lending, vault, fixed_yield, real_world_asset, concentrated_liquidity_pool, liquidity_pool, liquid_staking

offset · number · default: 0

Offset for pagination

Required range: x >= 0

limit · number

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

Required range: x >= 1

Response

200

application/json

Returns tokens with available enabled yields

total · number · required

Total number of items available

Example:

100

offset · number · required

Offset of the current page

Example:

0

limit · number · required

Limit of the current page

Example:

20

items · object[]

Show child attributes