واجهة برمجة تطبيقات العوائد المشفرة للأسعار الحالية والتاريخية.

// Best stablecoin yield: fetch USDC lending rates, sort by rate
const res = await fetch(
  "https://api.bitcompare.net/api/v1/rates/USDC?category=lending",
  { headers: { Authorization: `Bearer ${process.env.BITCOMPARE_API_KEY}` } }
)
const { data } = await res.json()
const best = data.rates.sort((a, b) => Number(b.rate) - Number(a.rate))[0]

{
  "data": {
    "symbol": "USDC",
    "rates": [
      {
        "provider": "earnpark",
        "symbol": "USDC",
        "category": "lending",
        "rate": 10.00004127,
        "metadata": {
          "userAssets[0]AssetRiskLevel": "MEDIUM",
          "userAssets[0]AssetPayoutType": "DAILY"
        },
        "lastUpdated": "2026-08-02T04:20:53.907Z",
        "coinId": "usd-coin",
        "providerSymbol": "USDC",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 167,
        "stale": false
      },
      {
        "provider": "youhodler",
        "symbol": "USDC",
        "category": "lending",
        "rate": 12,
        "metadata": null,
        "lastUpdated": "2026-08-02T04:20:51.785Z",
        "coinId": "usd-coin",
        "providerSymbol": "USDC",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 169,
        "stale": false
      }
    ],
    "count": 16
  }
}

# Track staking rewards for ETH
curl -s "https://api.bitcompare.net/api/v1/rates/ETH?category=staking" \
  -H "Authorization: Bearer $BITCOMPARE_API_KEY"

{
  "data": {
    "symbol": "ETH",
    "rates": [
      {
        "provider": "nexo",
        "symbol": "ETH",
        "category": "staking",
        "rate": 6.25,
        "metadata": {
          "source": "nexo_earn_api",
          "duration": 30,
          "flexRate": 3.25,
          "baseSymbol": "ETH",
          "cryptoName": "Ether",
          "hasFloorApy": false,
          "durationType": "fixed",
          "rewardsClaim": "automatic",
          "warmUpPeriod": {
            "type": "range",
            "numbers": [
              1,
              1
            ],
            "periods": [
              "day",
              "day"
            ]
          },
          "rewardsPayout": "automatic",
          "rewardFrequency": {
            "text": "daily",
            "type": "text"
          },
          "minPurchaseAmount": "0.26668219",
          "undelegationPeriod": {
            "text": "immediate",
            "type": "text"
          },
          "flexProviderSymbol": "ETH-FLEX"
        },
        "lastUpdated": "2026-08-02T04:20:55.609Z",
        "coinId": "ethereum",
        "providerSymbol": "ETH-30D",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 139,
        "stale": false
      },
      {
        "provider": "frax",
        "symbol": "ETH",
        "category": "staking",
        "rate": 2.71929941,
        "metadata": {
          "url": "https://api.frax.finance/v2/frxeth/summary/latest",
          "field": "sfrxethApr",
          "source": "multi_source"
        },
        "lastUpdated": "2026-08-02T04:20:53.384Z",
        "coinId": "ethereum",
        "providerSymbol": "ETH",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 141,
        "stale": false
      }
    ],
    "count": 11
  }
}

// Compare BTC lending vs borrowing rates (one call per category)
const [lending, borrowing] = await Promise.all(
  ["lending", "borrowing"].map((category) =>
    fetch(
      `https://api.bitcompare.net/api/v1/rates/BTC?category=${category}`,
      { headers: { Authorization: `Bearer ${process.env.BITCOMPARE_API_KEY}` } }
    ).then((r) => r.json())
  )
)
const spread =
  Number(borrowing.data.rates[0].rate) - Number(lending.data.rates[0].rate)

{
  "data": {
    "symbol": "BTC",
    "rates": [
      {
        "provider": "aqru",
        "symbol": "BTC",
        "category": "lending",
        "rate": 2.5,
        "metadata": null,
        "lastUpdated": "2026-08-02T04:25:36.300Z",
        "coinId": "bitcoin",
        "providerSymbol": "BTC",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 198,
        "stale": false
      },
      {
        "provider": "aave-v3",
        "symbol": "BTC",
        "category": "lending",
        "rate": 0.00749523,
        "metadata": {
          "mode": "aave_liquidity_rate",
          "method": "getReserveData",
          "source": "onchain_rate",
          "chainId": 1,
          "contract": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"
        },
        "lastUpdated": "2026-08-02T04:25:25.284Z",
        "coinId": "bitcoin",
        "providerSymbol": "BTC",
        "unitType": "percentage",
        "unitSymbol": "%",
        "ageSeconds": 209,
        "stale": false
      }
    ],
    "count": 14
  }
}