BitcoinYield

npx add-mcp 'https://bitcoinyield.co/api/mcp'

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.

GET

/api/v1/yields

public

One 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-26T21:00:24.532Z",
  "count": 66,
  "yields": [
    {
      "asset": "USDC", "slug": "usdc",
      "best_apy": 12.513, "best_platform": "Accountable",
      "risk_tier": "C", "stablecoin": true,
      "platform_count": 131, "url": "https://bitcoinyield.co/assets/usdc"
    },
    {
      "asset": "BTC", "slug": "btc",
      "best_apy": 5.0536, "best_platform": "Accountable",
      "risk_tier": "B", "stablecoin": false,
      "url": "https://bitcoinyield.co/assets/btc"
    }
  ]
}

GET

/api/v1/prices

API key

Every 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-26T21:00:24.532Z",
  "count": 20,
  "offers": [
    {
      "provider": "accountable", "provider_label": "Accountable",
      "asset": "USDC", "asset_slug": "usdc",
      "product_type": "defi_lending", "chain": "Ethereum",
      "apy": 12.513, "risk_tier": "C",
      "fetched_at": "2026-09-26T21:00:24.532846+00:00"
    }
  ]
}

Filtering the feed

API key

Narrow /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: defi_lending or cefi_earn, defi_lp or defi_vault, liquid_staking, restaking, or fixed.

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, BTC, ETH.

apy

The net APY, as a percent (for example 12.513 means 12.513%), with apy_base and apy_reward splitting organic from incentives.

provider / provider_label

The platform paying the yield, machine key and display name.

chain / risk_tier / tvl_usd

The chain (empty for custodial CeFi), the A-D risk grade, and the pool’s total value locked.

MCP server

for AI agentsno install

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

Create an API key →