Skip to main content

BitcoinYield

by co.bitcoinyield

Overview Discussions Admin

List the top live offers for one asset

list_offers

Read-onlyIdempotent

The top live yield offers for one asset (5 by default, up to 20) in BitcoinYield's own order: rate and risk together, with offers that have a month of steady history and $10M+ of liquidity first. Each offer carries its platform, chain, product type, rate (APY or APR), organic versus incentive split, 30-day average, liquidity, A-D risk grade with its main reasons, US availability, investor access, the platform's own deposit link and the page to cite. Filter by chain or a risk ceiling. Use it to compare options; list_yields gives one pick per asset. Rates are variable and not advice. No key required. When nothing matches, the answer says why: the filters, a dollar that lost its peg, or no live quote on the asset.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`asset`	Yes	The asset's symbol, e.g. BTC, USDC or USDE.
`chain`	No	Only offers on this chain, e.g. Ethereum, Base, Arbitrum or Solana (case-insensitive). Centralized (CeFi) offers have no chain.
`limit`	No	How many offers to return, 1 to 20 (default 5).
`max_risk`	No	Only offers graded at or below this letter: A (lower risk), B (moderate), C (elevated), D (higher).

Output Schema

TableJSON Schema

Name	Required	Description	Default
`url`	Yes	The asset's full comparison on BitcoinYield.
`asset`	Yes
`count`	Yes
`stale`	No	True when part of this snapshot is over 6 hours old (a scheduled refresh was missed).
`offers`	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 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"
+]

Changed2 schema fields changedOct 15, 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",
+  "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"
+]

changedOutput schema / properties / offers / items / properties / durability / description

Previous value: -"The rate (as shown and ordered) against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); lumpy when a realized rate's 1-day, 7-day and 30-day readings disagree (income booked in lumps); insufficient under a month of history."New value: +"The rate (as shown and ordered) against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); lumpy when the larger of a realized rate's 7-day and 30-day returns is more than 1.6 times the smaller (income booked in lumps); insufficient under a month of history."

Changed1 schema field changedOct 14, 2026

addedOutput schema / properties / offers / items / properties / maturity

Added value: +{
+  "description": "For a fixed rate, the date it ends (YYYY-MM-DD): a Pendle principal token's maturity, when the locked rate stops and the token redeems for its underlying. Null for every other product.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed6 schema fields changedOct 13, 2026

changedOutput schema / properties / offers / items / properties / rate / description

Previous value: -"The annual rate in percent (5.2 means 5.2%) as BitcoinYield shows it and orders on it: today's reported rate, or its 7-day average when that is lower, so a one-day spike never leads."New value: +"The annual rate in percent (5.2 means 5.2%) as BitcoinYield shows it and orders on it: the latest reading (rate_today), or its 7-day average when that is lower, so a one-day spike never leads. A DeFi rate is measured from the protocol's own contracts (what the deposit token actually earned) or read from the protocol's own API; an exchange's from its own API. Never a forecast."

changedOutput schema / properties / offers / items / properties / rate_basis / description

Previous value: -"Whether the source reports the rate as APY (compounded) or APR; unknown when it does not say."New value: +"Whether the rate is an APY (compounded) or an APR. A rate measured from a protocol's contracts is an APY; a published rate keeps its source's convention; unknown when the source does not say."

changedOutput schema / properties / offers / items / properties / rate_rewards / description

Previous value: -"The part of rate paid as incentive rewards, which last only as long as someone funds them (beside a rate held at its 7-day average, scaled to that rate)."New value: +"The part of rate paid as incentive rewards, which last only as long as someone funds them (beside a rate held at its 7-day average, scaled to that rate). Null when the source states no reward part: a rate measured from a protocol's contracts counts only what the deposit token itself earns, not incentives paid separately."

changedOutput schema / properties / offers / items / properties / rate_source_url / description

Previous value: -"Where the rate was read."New value: +"Where anyone can check the rate: the contract it is read from, on a block explorer, or the exchange's or protocol's own page."

changedOutput schema / properties / offers / items / properties / rate_today / description

Previous 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."New value: +"The latest reading: for a lending market its latest day's rate, 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."

changedOutput schema / properties / offers / items / properties / rewards_program / description

Previous value: -"Who pays rate_rewards and how far ahead it is funded, when the incentive program is known (Merkl campaigns on Morpho, Euler, Aave and Fluid); null otherwise."New value: +"Who pays rate_rewards and how far ahead it is funded, when the incentive program is known (Merkl campaigns); null otherwise."

Changed4 schema fields changedOct 12, 2026

changedOutput schema / properties / offers / items / properties / durability / description

Previous value: -"Today's rate against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); lumpy when a realized rate's 1-day, 7-day and 30-day readings disagree (income booked in lumps); insufficient under a month of history."New value: +"The rate (as shown and ordered) against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); lumpy when a realized rate's 1-day, 7-day and 30-day readings disagree (income booked in lumps); insufficient under a month of history."

changedOutput schema / properties / offers / items / properties / rate_base / description

Previous value: -"The organic part of the rate (interest, fees, staking), before incentive rewards."New value: +"The organic part of rate (interest, fees, staking); rate_base + rate_rewards = rate."

changedOutput schema / properties / offers / items / properties / rate_rewards / description

Previous value: -"The part paid as incentive rewards, which last only as long as someone funds them."New value: +"The part of rate paid as incentive rewards, which last only as long as someone funds them (beside a rate held at its 7-day average, scaled to that rate)."

changedOutput schema / properties / offers / items / 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."

Changed2 schema fields changedOct 8, 2026

changedOutput schema / properties / offers / items / properties / liquidity_usd / description

Previous value: -"The liquidity a depositor can exit into, in US dollars: a lending pool's withdrawable amount, a credit pool's cash, or for a staking token what sells at once within 1% of its market price (the rest of its stake leaves through its issuer's queue, see exit). Null when the source reports none (custodial desks)."New value: +"The liquidity a depositor can exit into, in US dollars: a lending pool's withdrawable amount, a credit pool's cash, or for a staking token what sells at once within 1% of its market price (the rest of its stake leaves through its issuer's queue, see exit), or for a fund its issuer redeems what its redemption vault pays at once. Null when the source reports none (custodial desks)."

changedOutput schema / properties / offers / items / properties / us_available / description

Previous value: -"Whether a US retail user can open it."New value: +"Whether a US retail user can open it: no when the platform or issuer excludes US persons, or admits only accredited investors or invited addresses (see access)."

Changed5 schema fields changedOct 8, 2026

changedOutput schema / properties / offers / items / properties / avg_7d / description

Previous value: -"The rate's 7-day average. The order reads the lower of rate and avg_7d, so a one-day spike never leads."New value: +"The rate's 7-day average (rate is the lower of it and rate_today)."

changedOutput schema / properties / offers / items / properties / liquidity_usd / description

Previous value: -"The liquidity a depositor can exit into, in US dollars; null when the source reports none (custodial desks)."New value: +"The liquidity a depositor can exit into, in US dollars: a lending pool's withdrawable amount, a credit pool's cash, or for a staking token what sells at once within 1% of its market price (the rest of its stake leaves through its issuer's queue, see exit). Null when the source reports none (custodial desks)."

changedOutput schema / properties / offers / items / properties / rate / description

Previous value: -"The reported annual rate in percent (5.2 means 5.2%)."New value: +"The annual rate in percent (5.2 means 5.2%) as BitcoinYield shows it and orders on it: today's reported rate, or its 7-day average when that is lower, so a one-day spike never leads."

addedOutput schema / properties / offers / items / properties / rate_today

Added value: +{
+  "description": "Today's reported rate; above rate when today's reading is higher than the 7-day average.",
+  "type": "number"
+}

changedOutput schema / properties / offers / items / required

Previous value: -[
-  "rank",
-  "platform",
-  "product_type",
-  "rate",
-  "rate_basis",
-  "us_available",
-  "partner"
-]New value: +[
+  "rank",
+  "platform",
+  "product_type",
+  "rate",
+  "rate_today",
+  "rate_basis",
+  "us_available",
+  "partner"
+]

Changed2 schema fields changedOct 6, 2026

addedOutput schema / properties / offers / items / properties / avg_7d

Added value: +{
+  "description": "The rate's 7-day average. The order reads the lower of rate and avg_7d, so a one-day spike never leads.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changedOutput schema / properties / offers / items / properties / durability / description

Previous value: -"Today's rate against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); insufficient under a month of history."New value: +"Today's rate against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); lumpy when a realized rate's 1-day, 7-day and 30-day readings disagree (income booked in lumps); insufficient under a month of history."

Changed1 schema field changedOct 5, 2026

addedOutput schema / properties / offers / items / properties / exit

Added value: +{
+  "description": "How a holder gets the underlying back at full value, as its issuer states it: a withdrawal queue, a cooldown or a redemption wait, and whether the token can also be sold on a market at the market price. Null when none is on record; a lending market's exit is its liquidity_usd.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed10 schema fields changedOct 4, 2026

changedOutput schema / properties / offers / items / properties / chain / description

Previous value: -"Null for a centralized (CeFi) offer."New value: +"The chain the offer is on; null for a centralized (CeFi) offer."

changedOutput schema / properties / offers / items / properties / durability / description

Previous value: -"How today's rate compares with its 30-day average: durable, moderate, volatile, spiking, posted, or insufficient history."New value: +"Today's rate against its 30-day average: durable, moderate, volatile or spiking; posted when it has not moved in 30 days (a rate the platform sets); insufficient under a month of history."

addedOutput schema / properties / offers / items / properties / liquidity_usd / description

Added value: +"The liquidity a depositor can exit into, in US dollars; null when the source reports none (custodial desks)."

addedOutput schema / properties / offers / items / properties / platform / description
```
Added value: +"The platform's name, e.g. Aave V3."
```

addedOutput schema / properties / offers / items / properties / product_type / description

Added value: +"How the yield is produced, e.g. DeFi lending, Savings rate or Liquid staking."

addedOutput schema / properties / offers / items / properties / rank / description

Added value: +"The offer's place in BitcoinYield's order (rate and risk together), 1 first."

addedOutput schema / properties / offers / items / properties / rate / description
```
Added value: +"The reported annual rate in percent (5.2 means 5.2%)."
```
addedOutput schema / properties / offers / items / properties / risk_tier / description
```
Added value: +"BitcoinYield's A-D risk grade: A lower risk, D higher."
```

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."

Changed3 schema fields changedOct 4, 2026

changedOutput schema / properties / offers / items / properties / rate_base / description

Previous value: -"The organic part of the rate, before incentive-token rewards."New value: +"The organic part of the rate (interest, fees, staking), before incentive rewards."

changedOutput schema / properties / offers / items / properties / rate_rewards / description

Previous value: -"The part paid in incentive tokens, which can end at any time."New value: +"The part paid as incentive rewards, which last only as long as someone funds them."

addedOutput schema / properties / offers / items / properties / rewards_program

Added value: +{
+  "description": "Who pays rate_rewards and how far ahead it is funded, when the incentive program is known (Merkl campaigns on Morpho, Euler, Aave and Fluid); null otherwise.",
+  "properties": {
+    "funded_through": {
+      "description": "Last day (UTC, YYYY-MM-DD) the live round is funded through.",
+      "type": "string"
+    },
+    "paid_in": {
+      "description": "Reward token symbols.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "rounds": {
+      "description": "Rounds in that run, the live one included (1 = never renewed yet).",
+      "type": "integer"
+    },
+    "since": {
+      "description": "First day (UTC) of the unbroken run of rounds the live one belongs to.",
+      "type": "string"
+    },
+    "source": {
+      "enum": [
+        "merkl"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "paid_in",
+    "funded_through",
+    "since",
+    "rounds",
+    "source"
+  ],
+  "type": [
+    "object",
+    "null"
+  ]
+}

AddedOct 2, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations already cover the safety profile (read-only, idempotent, non-destructive), and the description adds real behavior: the ranking rule (rate and risk together, month of steady history and $10M+ liquidity first), auth needs ('No key required'), rate variability/disclaimer, and the empty-result contract explaining why nothing matched. It does not describe pagination beyond the limit parameter, but the added context is substantial.

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

Conciseness4/5

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

Purpose is front-loaded in the first sentence and the routing sentence is well placed. It is dense but single-paragraph and mostly earns its place; the long enumeration of return fields is partially redundant given a full output schema exists.

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?

For a read-only listing tool with a full output schema and 100% parameter coverage, the description adds the ranking logic, empty-state explanation, disclaimer, and auth note. Nothing an agent needs to call it correctly is missing.

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

Parameters3/5

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

Schema description coverage is 100% (including asset enum, chain, limit bounds, and risk grade meanings), so the schema already carries parameter meaning. The description only restates the limit default and filter axes ('Filter by chain or a risk ceiling') without adding syntax or format detail, so baseline 3 applies.

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?

States a specific verb+resource ('top live yield offers for one asset') plus scope and default sizing (5 by default, up to 20), and explicitly contrasts itself with the sibling: 'list_yields gives one pick per asset.' An agent can route between the two without opening a schema.

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?

Gives a direct when-to-use ('Use it to compare options') and names the alternative tool plus the condition that selects it (one pick per asset). Also states filtering options (chain, risk ceiling) and access requirements ('No key required').

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

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?