Rates

Query current and historical lending, borrowing, staking, and price rates from 45+ providers. Historical data is available for the last 30 days.

The rate model

Properties

Name
provider
Type
string
Description
The data provider (e.g., "aave", "compound", "kraken").
Name
symbol
Type
string
Description
The cryptocurrency symbol.
Name
category
Type
string
Description
Rate category: lending, borrowing, staking, or price.
Name
rate
Type
number
Description
The rate value. For lending/borrowing/staking this is a percentage (APY). For price this is the spot price.
Name
lastUpdated
Type
string
Description
ISO 8601 timestamp of when the rate was last updated.
Name
coinId
Type
string
Description
CoinGecko coin identifier (optional).
Name
providerSymbol
Type
string
Description
Provider-specific symbol representation (optional).
Name
metadata
Type
object
Description
Additional provider-specific metadata (optional).

GET/api/v1/rates

List all rates

Get all current rates with optional filtering by symbol, category, or provider.

Optional attributes

Name
symbol
Type
string
Description
Filter by cryptocurrency symbol.
Name
category
Type
string
Description
Filter by rate category: lending, borrowing, staking, or price.
Name
provider
Type
string
Description
Filter by provider name.
Name
limit
Type
integer
Description
Max results to return. Defaults to 100.

Request

GET

/api/v1/rates

curl -G https://api.bitcompare.net/api/v1/rates \
  -d symbol=USDC \
  -d category=lending

Response

{
  "data": {
    "rates": [
      {
        "provider": "aave",
        "symbol": "USDC",
        "category": "lending",
        "rate": 4.5,
        "lastUpdated": "2025-10-29T14:00:00Z",
        "coinId": "usd-coin",
        "metadata": {}
      }
    ],
    "count": 1,
    "timestamp": "2025-10-29T14:00:00Z"
  }
}

GET/api/v1/rates/:symbol

Get rates for symbol

Get current rates for a specific symbol across all providers.

Optional attributes

Name
category
Type
string
Description
Filter by rate category.
Name
provider
Type
string
Description
Filter by provider name.

Request

GET

/api/v1/rates/BTC

curl https://api.bitcompare.net/api/v1/rates/BTC

Response

{
  "data": {
    "symbol": "BTC",
    "rates": [
      {
        "provider": "kraken",
        "symbol": "BTC",
        "category": "price",
        "rate": 45000.00,
        "lastUpdated": "2025-10-29T14:00:00Z"
      },
      {
        "provider": "aave",
        "symbol": "BTC",
        "category": "lending",
        "rate": 0.15,
        "lastUpdated": "2025-10-29T13:55:00Z"
      }
    ],
    "count": 2
  }
}

GET/api/v1/rates/summary

Rate summary

Get an aggregated rate summary grouped by symbol and category. Returns min, max, and average rates with provider count.

Optional attributes

Name
symbol
Type
string
Description
Filter by symbol.
Name
category
Type
string
Description
Filter by category.

Request

GET

/api/v1/rates/summary

curl -G https://api.bitcompare.net/api/v1/rates/summary \
  -d category=lending

Response

{
  "data": {
    "summary": [
      {
        "symbol": "USDC",
        "category": "lending",
        "minRate": 2.1,
        "maxRate": 6.8,
        "averageRate": 4.2,
        "providerCount": 8,
        "latestUpdate": "2025-10-29T14:00:00Z"
      },
      {
        "symbol": "ETH",
        "category": "lending",
        "minRate": 0.5,
        "maxRate": 3.2,
        "averageRate": 1.8,
        "providerCount": 6,
        "latestUpdate": "2025-10-29T14:00:00Z"
      }
    ],
    "timestamp": "2025-10-29T14:00:00Z"
  }
}

GET/api/v1/rates/:symbol/history

Historical rates

Get historical rates for a symbol. Data is retained for 30 days.

Optional attributes

Name
category
Type
string
Description
Filter by rate category.
Name
from
Type
string
Description
Start date in ISO 8601 format.
Name
to
Type
string
Description
End date in ISO 8601 format.
Name
limit
Type
integer
Description
Max results. Defaults to 100.

Request

GET

/api/v1/rates/BTC/history

curl -G https://api.bitcompare.net/api/v1/rates/BTC/history \
  -d category=price \
  -d from=2025-10-28T00:00:00Z \
  -d limit=24

Response

{
  "data": {
    "symbol": "BTC",
    "history": [
      {
        "provider": "kraken",
        "symbol": "BTC",
        "category": "price",
        "rate": 45000.00,
        "lastUpdated": "2025-10-29T14:00:00Z"
      },
      {
        "provider": "kraken",
        "symbol": "BTC",
        "category": "price",
        "rate": 44800.00,
        "lastUpdated": "2025-10-29T13:00:00Z"
      }
    ],
    "count": 2
  }
}

GET/api/v1/rates/providers

List providers

Get a list of all rate providers with their current health status, categories, and success rates.

Request

GET

/api/v1/rates/providers

curl https://api.bitcompare.net/api/v1/rates/providers

GET/api/v1/rates/providers/:provider

Get provider details

Get detailed status for a specific provider including latest rates and category breakdowns.

Path parameters

Name
provider
Type
string
Description
Provider name (e.g., "aave", "compound").

Request

GET

/api/v1/rates/providers/aave

curl https://api.bitcompare.net/api/v1/rates/providers/aave

GET/api/v1/rates/history

Rate history (charts)

Get historical rate data for chart visualization. Supports querying by coin or platform with country-specific filtering.

Required attributes (one of)

Name
coin
Type
string
Description
Coin identifier for coin-based rate history.
Name
platform
Type
string
Description
Platform identifier for platform-based rate history.

Required attributes

Name
country
Type
string
Description
2-letter ISO country code (e.g., "US", "AU").
Name
product
Type
string
Description
Product type: lending-rates, loan-rates, or staking-rewards.

Optional attributes

Name
timeframe
Type
string
Description
Time period: 30d, 90d, 1y, or all. Defaults to 30d.
Name
limit
Type
integer
Description
Max number of series to return. Defaults to 6, max 20.

Request

GET

/api/v1/rates/history

curl -G https://api.bitcompare.net/api/v1/rates/history \
  -d coin=bitcoin \
  -d country=US \
  -d product=lending-rates \
  -d timeframe=30d