The ERC20 token contract address to find the best vault APY for. Required if tokenSymbol is not provided.

Token symbol to search for (e.g., "USDC", "WETH", "DAI", "USDT", "WBTC"). Required if tokenAddress is not provided. The correct contract address is resolved automatically per chain.

Chain ID. Supported: Ethereum (1), Base (8453), Arbitrum (42161), Optimism (10), Polygon (137). Optional — omit to search all supported chains.

Minimum vault TVL in USD to filter out small/test vaults. Defaults to 0 (include all vaults).

Minimum net APY as a percentage (e.g., 5 = 5%). Vaults below this threshold are excluded.

Maximum number of vaults to return (1–20). Defaults to 5.

The queried token address (or the address on the best vault's chain when using tokenSymbol)

The token symbol

The chain ID queried (or the best vault's chain when searching all chains)

The vault with the highest net APY

All vaults for this token sorted by net APY descending

Chain IDs that were searched