BitcoinYield API
One normalized, always-fresh feed of live crypto yields across DeFi and CeFi: lending, pools, vaults, staking, fixed-rate and custodial earn, ranked by yield and risk. Every value is a live figure with a fetch timestamp, and each row carries its base-vs-reward split, TVL and risk grade. Power yield dashboards, treasury tools, or your agents, over plain REST or MCP.
/api/v1/yields
publicOne entry per asset with its best current yield across DeFi and CeFi, its A-D risk grade and a link to the full comparison. best_apy is a percent. No key required. Optional asset, stablecoin and max_risk (A to D: only offers graded at or below that letter) filters.
curl https://bitcoinyield.co/api/v1/yields{
"updated_at": "2026-09-27T06:23:34.178Z",
"count": 66,
"yields": [
{
"asset": "USDC", "slug": "usdc",
"best_apy": 10.92359, "best_platform": "Ember Protocol",
"risk_tier": "C", "stablecoin": true,
"platform_count": 103, "url": "https://bitcoinyield.co/assets/usdc"
},
{
"asset": "BTC", "slug": "btc",
"best_apy": 2.84392, "best_platform": "Mezo Earn",
"risk_tier": "C", "stablecoin": false,
"url": "https://bitcoinyield.co/assets/btc"
}
]
}/api/v1/prices
API keyEvery normalized live yield opportunity (platform, asset, product type, chain, APY, base/reward split, TVL, risk grade). Filter with asset, provider (platform), type, limit.
curl -H "Authorization: Bearer by_live_..." \
"https://bitcoinyield.co/api/v1/prices?asset=usdc&limit=20"{
"updated_at": "2026-09-27T06:23:34.178Z",
"count": 20,
"offers": [
{
"provider": "ember-protocol", "provider_label": "Ember Protocol",
"asset": "USDC", "asset_slug": "usdc",
"product_type": "defi_vault", "chain": "Ethereum",
"apy": 10.92359, "risk_tier": "C",
"fetched_at": "2026-09-27T06:23:34.178Z"
}
]
}Filtering the feed
API keyNarrow /api/v1/prices to exactly the yield you want. asset is the symbol or slug (usdc, btc), provider is the platform (aave-v3, nexo), and type is how the yield is produced, one of defi_lending, savings, defi_lp, farm, defi_vault, liquid_staking, restaking, fixed, synthetic, backstop, private_credit, rwa_fund, cefi_earn, or structured_option (the methodology explains each).
curl -H "Authorization: Bearer by_live_..." \
"https://bitcoinyield.co/api/v1/prices?provider=aave-v3&asset=usdc&limit=20"The fields in each offer:
asset
The asset symbol you earn on: USDC, USDT, , .
MCP server
for AI agentsno installConnect any MCP client (Claude, Cursor, or an autonomous agent) to the hosted server over Streamable HTTP (protocol 2026-07-28, with the earlier handshake still supported). Tool: list_yields returns the best current yield per asset across DeFi and CeFi with its risk grade, optionally capped with max_risk. Nothing to install.
{
"mcpServers": {
"bitcoinyield": { "url": "https://bitcoinyield.co/api/mcp" }
}
}Machine-readable discovery: /openapi.json (OpenAPI 3.1), agent card, and llms.txt.
Get an API key
Create and manage keys in your dashboard to access the full yield feed. Keys are shown once at creation. Include yours as an Authorization: Bearer header.