BitcoinYield

List the best yield per asset

list_yields

Read-onlyIdempotent

One entry per asset (Bitcoin, ETH, SOL, USDC, USDT and every other tracked stablecoin, tokenized Treasury and L1) with its best current yield across DeFi and CeFi under BitcoinYield's risk-weighted ranking, its A-D risk grade, and a link to the full comparison. by_grade gives the best proven rate at grade A, B and C (A = lower risk), the tradeoff a holder chooses between: a grade is null when nothing proven at it pays materially more (at least 0.05 points and 5%) than a safer grade. best_apy and each by_grade rate are in percent (0.17 means 0.17%), as the asset page shows them (today's rate, or its 7-day average when that is lower); quote best_rate_text and each by_grade rate_text, which print them with their unit, APY or APR. To answer 'what is the best yield on X', quote by_grade, the lowest-risk grade first: best_apy is the by_grade step the risk-weighted ranking puts first and can be a higher-risk one, or one closed to US residents. An asset with no proven offer has no pick: best_apy is null and no_pick_reason says why its top-ranked offer is not one. Set max_risk to limit every pick to offers graded at or below that letter. Rates are variable and not advice. No key required. With no asset or stablecoin filter this tool answers the headline assets (BTC, ETH, SOL, USDC, USDT, DAI, USDe, USD1, USDG, PYUSD, RLUSD); set all to true for every asset with a live yield.

Input Schema

Name	Required	Description
`all`	No	Set to true for every asset with a live yield (about 60 entries, a large answer) instead of the headline assets. Ignored when asset or stablecoin is set.
`asset`	No	Filter to one asset by its symbol, e.g. BTC, USDC or USDE. For a token an asset is held as, give the asset: BTC for WBTC, ETH for stETH, DAI for USDS or sUSDS, SOL for jitoSOL (the tokens themselves are also read as their asset).
`max_risk`	No	Only consider offers graded at or below this letter: A (lower risk), B (moderate), C (elevated), D (higher).
`stablecoin`	No	Set to true to return only stablecoin assets.

Output Schema

Name	Required	Description
`count`	Yes
`stale`	No	True when part of this snapshot is over 6 hours old (a scheduled refresh was missed).
`yields`	Yes
`partial`	No	True when a data source was missing from this snapshot.
`updated_at`	No	When the feed was last refreshed (ISO 8601). It refreshes every 3 hours.
`degraded_sources`	No	The sources missing from this snapshot, if any.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 7, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedNov 7, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedNov 4, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedNov 3, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USD0",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "DEUSD",
-  "USDF",
-  "USR",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "BUIDL",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "VBILL",
-  "THBILL",
-  "ACRED",
-  "STAC",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "VUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedNov 3, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USD0",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "DEUSD",
+  "USDF",
+  "USR",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "BUIDL",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "VBILL",
+  "THBILL",
+  "ACRED",
+  "STAC",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "VUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedOct 31, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedOct 31, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed9 schema fields changedOct 26, 2026

addedOutput schema / properties / yields / items / properties / best_rate_text

Added value: +{
+  "description": "best_apy as the page prints it, with its unit (\"0.17% APY\"): the figure to quote. Null with no pick.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / yields / items / properties / by_grade / properties / A / properties / rate_text

Added value: +{
+  "description": "rate as the page prints it, with its unit (\"6.13% APY\"): the figure to quote.",
+  "type": "string"
+}

changedOutput schema / properties / yields / items / properties / by_grade / properties / A / required

Previous value: -[
-  "rate",
-  "rate_today",
-  "rate_basis",
-  "platform",
-  "market",
-  "us_available",
-  "url"
-]New value: +[
+  "rate",
+  "rate_text",
+  "rate_today",
+  "rate_basis",
+  "platform",
+  "market",
+  "us_available",
+  "url"
+]

addedOutput schema / properties / yields / items / properties / by_grade / properties / B / properties / rate_text

Added value: +{
+  "description": "rate as the page prints it, with its unit (\"6.13% APY\"): the figure to quote.",
+  "type": "string"
+}

changedOutput schema / properties / yields / items / properties / by_grade / properties / B / required

Previous value: -[
-  "rate",
-  "rate_today",
-  "rate_basis",
-  "platform",
-  "market",
-  "us_available",
-  "url"
-]New value: +[
+  "rate",
+  "rate_text",
+  "rate_today",
+  "rate_basis",
+  "platform",
+  "market",
+  "us_available",
+  "url"
+]

addedOutput schema / properties / yields / items / properties / by_grade / properties / C / properties / rate_text

Added value: +{
+  "description": "rate as the page prints it, with its unit (\"6.13% APY\"): the figure to quote.",
+  "type": "string"
+}

changedOutput schema / properties / yields / items / properties / by_grade / properties / C / required

Previous value: -[
-  "rate",
-  "rate_today",
-  "rate_basis",
-  "platform",
-  "market",
-  "us_available",
-  "url"
-]New value: +[
+  "rate",
+  "rate_text",
+  "rate_today",
+  "rate_basis",
+  "platform",
+  "market",
+  "us_available",
+  "url"
+]

changedOutput schema / properties / yields / items / properties / peg_price / description

Previous value: -"For a stablecoin: the live price of the dollar the best yield is paid in (1 = on its $1 peg). Null when unpriced or not a stablecoin."New value: +"For a stablecoin: the live price of the dollar the best yield is paid in (1 = on its $1 peg). Null when unpriced, not a stablecoin, or a dollar whose value accrues by design (Re's reUSD), which trades above $1."

changedOutput schema / properties / yields / items / required

Previous value: -[
-  "asset",
-  "best_apy",
-  "rate_basis",
-  "best_platform",
-  "no_pick_reason",
-  "url",
-  "by_grade"
-]New value: +[
+  "asset",
+  "best_apy",
+  "best_rate_text",
+  "rate_basis",
+  "best_platform",
+  "no_pick_reason",
+  "url",
+  "by_grade"
+]

Changed1 schema field changedOct 22, 2026

changedInput schema / properties / asset / description

Previous value: -"Filter to one asset by its symbol, e.g. BTC, USDC or USDE. A token an asset is held as is read as that asset (USDS and sUSDS as DAI, stETH as ETH, WBTC as BTC, jitoSOL as SOL)."New value: +"Filter to one asset by its symbol, e.g. BTC, USDC or USDE. For a token an asset is held as, give the asset: BTC for WBTC, ETH for stETH, DAI for USDS or sUSDS, SOL for jitoSOL (the tokens themselves are also read as their asset)."

Changed7 schema fields changedOct 19, 2026

changedInput schema / properties / asset / description

Previous value: -"Filter to one asset by its symbol, e.g. BTC, USDC or USDE."New value: +"Filter to one asset by its symbol, e.g. BTC, USDC or USDE. A token an asset is held as is read as that asset (USDS and sUSDS as DAI, stETH as ETH, WBTC as BTC, jitoSOL as SOL)."

changedOutput schema / properties / yields / items / properties / best_apy / description

Previous value: -"The top-ranked offer's rate in percent (5.2 means 5.2%) as its page shows it: today's rate, or its 7-day average when that is lower. An APR when rate_basis says so; the name is kept for compatibility. The top of the risk-weighted ranking, which can be a higher-risk offer than by_grade's grade-A step."New value: +"The pick's rate in percent (5.2 means 5.2%) as its page shows it: today's rate, or its 7-day average when that is lower. An APR when rate_basis says so; the name is kept for compatibility. The pick is the by_grade step the risk-weighted ranking puts first, which can be a higher-risk step than grade A. Null when the asset has no pick yet (no_pick_reason)."

changedOutput schema / properties / yields / items / properties / best_apy / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```
changedOutput schema / properties / yields / items / properties / best_platform / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```

addedOutput schema / properties / yields / items / properties / no_pick_reason

Added value: +{
+  "description": "Why the asset has no pick, as its page says under its top-ranked offer (e.g. \"the top-ranked offer, 18.5% APY on Pendle, is graded D, the highest risk\"). Relay it instead of a rate. Null when best_apy is set.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

changedOutput schema / properties / yields / items / properties / rate_basis / description

Previous value: -"Whether the source reports best_apy as an APY (compounded) or an APR; unknown when it does not say."New value: +"Whether the source reports best_apy as an APY (compounded) or an APR; unknown when it does not say or there is no pick."

changedOutput schema / properties / yields / items / required

Previous value: -[
-  "asset",
-  "best_apy",
-  "rate_basis",
-  "best_platform",
-  "url",
-  "by_grade"
-]New value: +[
+  "asset",
+  "best_apy",
+  "rate_basis",
+  "best_platform",
+  "no_pick_reason",
+  "url",
+  "by_grade"
+]

Changed1 schema field changedOct 18, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedOct 18, 2026

changedOutput schema / properties / yields / items / properties / by_grade / description

Previous value: -"The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays materially more (at least 0.05 points and 5%) than a safer grade, both on its rate and on its rate without temporary rewards."New value: +"The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays materially more (at least 0.05 points and 5%) than a safer grade, both on its rate and on its rate without temporary rewards; between offers of one grade that pay about the same, the one paying materially more without temporary rewards is the pick."

Changed1 schema field changedOct 18, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedOct 18, 2026

changedOutput schema / properties / yields / items / properties / by_grade / description

Previous value: -"The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays materially more (at least 0.05 points and 5%) than a safer grade."New value: +"The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays materially more (at least 0.05 points and 5%) than a safer grade, both on its rate and on its rate without temporary rewards."

Changed1 schema field changedOct 16, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedOct 16, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedOct 16, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed1 schema field changedOct 15, 2026

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "USDF",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "THBILL",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

Changed5 schema fields changedOct 15, 2026

addedInput schema / properties / all

Added value: +{
+  "description": "Set to true for every asset with a live yield (about 60 entries, a large answer) instead of the headline assets. Ignored when asset or stablecoin is set.",
+  "type": "boolean"
+}

changedInput schema / properties / asset / enum

Previous value: -[
-  "BTC",
-  "ETH",
-  "SOL",
-  "USDC",
-  "USDT",
-  "DAI",
-  "USDE",
-  "GHO",
-  "CRVUSD",
-  "PYUSD",
-  "RLUSD",
-  "FRAX",
-  "USD1",
-  "USDY",
-  "USD0",
-  "USDG",
-  "AUSD",
-  "USDD",
-  "USD3",
-  "REUSD",
-  "USDX",
-  "DEUSD",
-  "USDF",
-  "USR",
-  "USDAI",
-  "JUPUSD",
-  "AVUSD",
-  "BNB",
-  "AVAX",
-  "TRX",
-  "HYPE",
-  "LINK",
-  "XRP",
-  "POL",
-  "SKY",
-  "CRV",
-  "SUI",
-  "CVX",
-  "AERO",
-  "BUIDL",
-  "USYC",
-  "USTB",
-  "OUSG",
-  "USCC",
-  "TBILL",
-  "VBILL",
-  "THBILL",
-  "ACRED",
-  "STAC",
-  "ONYC",
-  "STBT",
-  "DOLA",
-  "FRXUSD",
-  "MSUSD",
-  "FXUSD",
-  "APXUSD",
-  "APYUSD",
-  "STRUSD",
-  "SYZUSD",
-  "VUSD",
-  "STCUSD",
-  "USDU",
-  "SRUSD",
-  "BOLD",
-  "LISUSD",
-  "YUSD",
-  "BUCK",
-  "EURC",
-  "EURE"
-]New value: +[
+  "BTC",
+  "ETH",
+  "SOL",
+  "USDC",
+  "USDT",
+  "DAI",
+  "USDE",
+  "GHO",
+  "CRVUSD",
+  "PYUSD",
+  "RLUSD",
+  "FRAX",
+  "USD1",
+  "USDY",
+  "USDG",
+  "AUSD",
+  "USDD",
+  "USD3",
+  "REUSD",
+  "USDX",
+  "USDF",
+  "USDAI",
+  "JUPUSD",
+  "AVUSD",
+  "BNB",
+  "AVAX",
+  "TRX",
+  "HYPE",
+  "LINK",
+  "XRP",
+  "POL",
+  "SKY",
+  "CRV",
+  "SUI",
+  "CVX",
+  "AERO",
+  "USYC",
+  "USTB",
+  "OUSG",
+  "USCC",
+  "TBILL",
+  "THBILL",
+  "ONYC",
+  "STBT",
+  "DOLA",
+  "FRXUSD",
+  "MSUSD",
+  "FXUSD",
+  "APXUSD",
+  "APYUSD",
+  "STRUSD",
+  "SYZUSD",
+  "STCUSD",
+  "USDU",
+  "SRUSD",
+  "BOLD",
+  "LISUSD",
+  "YUSD",
+  "BUCK",
+  "EURC",
+  "EURE"
+]

changedInput schema / properties / stablecoin / description

Previous value: -"Set to \"true\" to return only stablecoin assets."New value: +"Set to true to return only stablecoin assets."

removedInput schema / properties / stablecoin / enum
```
Removed value: -[
-  "true",
-  "false"
-]
```
changedInput schema / properties / stablecoin / type
```
Previous value: -"string"New value: +"boolean"
```

Changed6 schema fields changedOct 12, 2026

addedOutput schema / properties / yields / items / properties / by_grade / properties / A / properties / rate_rewards

Added value: +{
+  "description": "The part of rate paid as temporary incentive rewards, which last only while someone funds them; null when under a tenth of rate. Say it when you quote rate.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changed

Output schema / properties / yields / items / properties / by_grade / properties / A / properties / rate_today / description

Previous value: -"Today's reported rate; above rate when today's reading is higher than the 7-day average."New value: +"The latest reading: today's rate, or for a vault, pool or staking token the middle of its 1-day, 7-day and 30-day realized returns. Above rate when that reading is higher than the 7-day average."

addedOutput schema / properties / yields / items / properties / by_grade / properties / B / properties / rate_rewards

Added value: +{
+  "description": "The part of rate paid as temporary incentive rewards, which last only while someone funds them; null when under a tenth of rate. Say it when you quote rate.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changed

Output schema / properties / yields / items / properties / by_grade / properties / B / properties / rate_today / description

Previous value: -"Today's reported rate; above rate when today's reading is higher than the 7-day average."New value: +"The latest reading: today's rate, or for a vault, pool or staking token the middle of its 1-day, 7-day and 30-day realized returns. Above rate when that reading is higher than the 7-day average."

addedOutput schema / properties / yields / items / properties / by_grade / properties / C / properties / rate_rewards

Added value: +{
+  "description": "The part of rate paid as temporary incentive rewards, which last only while someone funds them; null when under a tenth of rate. Say it when you quote rate.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changed

Output schema / properties / yields / items / properties / by_grade / properties / C / properties / rate_today / description

Previous value: -"Today's reported rate; above rate when today's reading is higher than the 7-day average."New value: +"The latest reading: today's rate, or for a vault, pool or staking token the middle of its 1-day, 7-day and 30-day realized returns. Above rate when that reading is higher than the 7-day average."

Changed7 schema fields changedOct 8, 2026

changedOutput schema / properties / yields / items / properties / best_apy / description

Previous value: -"The pick's rate in percent (5.2 means 5.2%) as its page quotes it: today's rate, or its 7-day average when today's is a spike above it. An APR when rate_basis says so; the name is kept for compatibility."New value: +"The top-ranked offer's rate in percent (5.2 means 5.2%) as its page shows it: today's rate, or its 7-day average when that is lower. An APR when rate_basis says so; the name is kept for compatibility. The top of the risk-weighted ranking, which can be a higher-risk offer than by_grade's grade-A step."

changedOutput schema / properties / yields / items / properties / by_grade / properties / A / properties / rate / description

Previous value: -"The step's annual rate in percent as its page quotes it: today's rate, or its 7-day average when today's is a spike above it."New value: +"The step's annual rate in percent as its page shows it: today's rate, or its 7-day average when that is lower."

changed

Output schema / properties / yields / items / properties / by_grade / properties / A / properties / rate_today / description

Previous value: -"Today's reported rate; differs from rate only on a spike."New value: +"Today's reported rate; above rate when today's reading is higher than the 7-day average."

changedOutput schema / properties / yields / items / properties / by_grade / properties / B / properties / rate / description

Previous value: -"The step's annual rate in percent as its page quotes it: today's rate, or its 7-day average when today's is a spike above it."New value: +"The step's annual rate in percent as its page shows it: today's rate, or its 7-day average when that is lower."

changed

Output schema / properties / yields / items / properties / by_grade / properties / B / properties / rate_today / description

Previous value: -"Today's reported rate; differs from rate only on a spike."New value: +"Today's reported rate; above rate when today's reading is higher than the 7-day average."

changedOutput schema / properties / yields / items / properties / by_grade / properties / C / properties / rate / description

Previous value: -"The step's annual rate in percent as its page quotes it: today's rate, or its 7-day average when today's is a spike above it."New value: +"The step's annual rate in percent as its page shows it: today's rate, or its 7-day average when that is lower."

changed

Output schema / properties / yields / items / properties / by_grade / properties / C / properties / rate_today / description

Previous value: -"Today's reported rate; differs from rate only on a spike."New value: +"Today's reported rate; above rate when today's reading is higher than the 7-day average."

Changed11 schema fields changedOct 6, 2026

changedOutput schema / properties / yields / items / properties / best_apy / description

Previous value: -"The best current rate in percent (5.2 means 5.2%). An APR when rate_basis says so; the name is kept for compatibility."New value: +"The pick's rate in percent (5.2 means 5.2%) as its page quotes it: today's rate, or its 7-day average when today's is a spike above it. An APR when rate_basis says so; the name is kept for compatibility."

changedOutput schema / properties / yields / items / properties / by_grade / description

Previous value: -"The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays more than a safer grade."New value: +"The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays materially more (at least 0.05 points and 5%) than a safer grade."

changedOutput schema / properties / yields / items / properties / by_grade / properties / A / properties / rate / description

Previous value: -"The reported annual rate in percent."New value: +"The step's annual rate in percent as its page quotes it: today's rate, or its 7-day average when today's is a spike above it."

addedOutput schema / properties / yields / items / properties / by_grade / properties / A / properties / rate_today

Added value: +{
+  "description": "Today's reported rate; differs from rate only on a spike.",
+  "type": "number"
+}

changedOutput schema / properties / yields / items / properties / by_grade / properties / A / required

Previous value: -[
-  "rate",
-  "rate_basis",
-  "platform",
-  "market",
-  "us_available",
-  "url"
-]New value: +[
+  "rate",
+  "rate_today",
+  "rate_basis",
+  "platform",
+  "market",
+  "us_available",
+  "url"
+]

changedOutput schema / properties / yields / items / properties / by_grade / properties / B / properties / rate / description

Previous value: -"The reported annual rate in percent."New value: +"The step's annual rate in percent as its page quotes it: today's rate, or its 7-day average when today's is a spike above it."

addedOutput schema / properties / yields / items / properties / by_grade / properties / B / properties / rate_today

Added value: +{
+  "description": "Today's reported rate; differs from rate only on a spike.",
+  "type": "number"
+}

changedOutput schema / properties / yields / items / properties / by_grade / properties / B / required

Previous value: -[
-  "rate",
-  "rate_basis",
-  "platform",
-  "market",
-  "us_available",
-  "url"
-]New value: +[
+  "rate",
+  "rate_today",
+  "rate_basis",
+  "platform",
+  "market",
+  "us_available",
+  "url"
+]

changedOutput schema / properties / yields / items / properties / by_grade / properties / C / properties / rate / description

Previous value: -"The reported annual rate in percent."New value: +"The step's annual rate in percent as its page quotes it: today's rate, or its 7-day average when today's is a spike above it."

addedOutput schema / properties / yields / items / properties / by_grade / properties / C / properties / rate_today

Added value: +{
+  "description": "Today's reported rate; differs from rate only on a spike.",
+  "type": "number"
+}

changedOutput schema / properties / yields / items / properties / by_grade / properties / C / required

Previous value: -[
-  "rate",
-  "rate_basis",
-  "platform",
-  "market",
-  "us_available",
-  "url"
-]New value: +[
+  "rate",
+  "rate_today",
+  "rate_basis",
+  "platform",
+  "market",
+  "us_available",
+  "url"
+]

Changed2 schema fields changedOct 5, 2026

addedOutput schema / properties / yields / items / properties / by_grade

Added value: +{
+  "description": "The best proven rate at each risk grade (a month of steady history and $10M or more to exit into). A grade is null when no proven offer of it pays more than a safer grade.",
+  "properties": {
+    "A": {
+      "properties": {
+        "chain": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "market": {
+          "description": "The vault, market or token the rate is paid in.",
+          "type": "string"
+        },
+        "platform": {
+          "type": "string"
+        },
+        "rate": {
+          "description": "The reported annual rate in percent.",
+          "type": "number"
+        },
+        "rate_basis": {
+          "enum": [
+            "apy",
+            "apr",
+            "unknown"
+          ],
+          "type": "string"
+        },
+        "url": {
+          "description": "This grade's offers on the asset's page.",
+          "type": "string"
+        },
+        "us_available": {
+          "description": "Whether a US retail user can open it.",
+          "enum": [
+            "yes",
+            "no",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "rate",
+        "rate_basis",
+        "platform",
+        "market",
+        "us_available",
+        "url"
+      ],
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "B": {
+      "properties": {
+        "chain": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "market": {
+          "description": "The vault, market or token the rate is paid in.",
+          "type": "string"
+        },
+        "platform": {
+          "type": "string"
+        },
+        "rate": {
+          "description": "The reported annual rate in percent.",
+          "type": "number"
+        },
+        "rate_basis": {
+          "enum": [
+            "apy",
+            "apr",
+            "unknown"
+          ],
+          "type": "string"
+        },
+        "url": {
+          "description": "This grade's offers on the asset's page.",
+          "type": "string"
+        },
+        "us_available": {
+          "description": "Whether a US retail user can open it.",
+          "enum": [
+            "yes",
+            "no",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "rate",
+        "rate_basis",
+        "platform",
+        "market",
+        "us_available",
+        "url"
+      ],
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "C": {
+      "properties": {
+        "chain": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "market": {
+          "description": "The vault, market or token the rate is paid in.",
+          "type": "string"
+        },
+        "platform": {
+          "type": "string"
+        },
+        "rate": {
+          "description": "The reported annual rate in percent.",
+          "type": "number"
+        },
+        "rate_basis": {
+          "enum": [
+            "apy",
+            "apr",
+            "unknown"
+          ],
+          "type": "string"
+        },
+        "url": {
+          "description": "This grade's offers on the asset's page.",
+          "type": "string"
+        },
+        "us_available": {
+          "description": "Whether a US retail user can open it.",
+          "enum": [
+            "yes",
+            "no",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "rate",
+        "rate_basis",
+        "platform",
+        "market",
+        "us_available",
+        "url"
+      ],
+      "type": [
+        "object",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "A",
+    "B",
+    "C"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / yields / items / required

Previous value: -[
-  "asset",
-  "best_apy",
-  "rate_basis",
-  "best_platform",
-  "url"
-]New value: +[
+  "asset",
+  "best_apy",
+  "rate_basis",
+  "best_platform",
+  "url",
+  "by_grade"
+]

Changed5 schema fields changedOct 4, 2026

addedOutput schema / properties / stale / description

Added value: +"True when part of this snapshot is over 6 hours old (a scheduled refresh was missed)."

addedOutput schema / properties / updated_at / description

Added value: +"When the feed was last refreshed (ISO 8601). It refreshes every 3 hours."

addedOutput schema / properties / yields / items / properties / best_apy / description

Added value: +"The best current rate in percent (5.2 means 5.2%). An APR when rate_basis says so; the name is kept for compatibility."

addedOutput schema / properties / yields / items / properties / rate_basis

Added value: +{
+  "description": "Whether the source reports best_apy as an APY (compounded) or an APR; unknown when it does not say.",
+  "enum": [
+    "apy",
+    "apr",
+    "unknown"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / yields / items / required

Previous value: -[
-  "asset",
-  "best_apy",
-  "best_platform",
-  "url"
-]New value: +[
+  "asset",
+  "best_apy",
+  "rate_basis",
+  "best_platform",
+  "url"
+]

Changed2 schema fields changedOct 2, 2026

addedOutput schema / properties / degraded_sources

Added value: +{
+  "description": "The sources missing from this snapshot, if any.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / partial

Added value: +{
+  "description": "True when a data source was missing from this snapshot.",
+  "type": "boolean"
+}

First observedSep 26, 2026

TDQS

A4.8/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the safety annotations, the description provides deep behavioral context: rates are variable, not advice; it defines the specific methodology (risk-weighted ranking, A-D grading); and it explains specific data edge cases (e.g., when `best_apy` is null and the `no_pick_reason` applies).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is highly detailed and dense, making it quite long. While every detail is technically useful for understanding this complex financial data, it sacrifices immediate conciseness. However, the information is well-structured logically rather than haphazardly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is exceptionally complete, covering data selection methods (today's rate vs. 7-day average), rate definitions (APY/APR, percent notation), and the conditional logic of the result set (what happens when no pick is available). It leaves almost no ambiguity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema coverage, the description provides critical semantic meaning to the parameters. It elaborates on the `asset` filtering nuance (e.g., using BTC for WBTC) and explains the quantitative and qualitative meaning of the `max_risk` grading system.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The tool purpose is explicitly stated as listing the 'best yield per asset' across DeFi and CeFi. It clearly defines the result structure, including the risk-weighted ranking and A-D grades, making its function unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description defines the tool's specific scope: providing the *best* proven rate. It clearly outlines how the various filters (`all`, `asset`, `max_risk`) modulate this search, guiding the agent on when this specific yield listing tool is appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All BitcoinYield tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?