Time-Series

Historical Rates API

Access rate history for chart visualization, trend analysis, and backtesting. Data available up to 5 years for Pro plans.

Free

7 days

Daily data points

Pro

5 years

Daily data points

Enterprise

5 years

Hourly + daily data

What You Can Build

Chart Visualization

Power line charts showing rate trends over time for coin or platform pages.

Trend Analysis

Analyze how rates change seasonally or in response to market events.

Backtesting

Test yield farming strategies against historical data.

Platform Comparison

Compare historical performance across providers for the same asset.

Endpoint

Query historical rates for a specific coin or platform. Either coin or platform must be provided (not both).

GEThttps://api.bitcompare.net/v1/rates/history?coin=ethereum&country=au&product=staking-rewards&timeframe=30d

curl -X GET "https://api.bitcompare.net/v1/rates/history?coin=ethereum&country=au&product=staking-rewards&timeframe=30d" \
  -H "Accept: application/json"

Response

{
  "meta": {
    "coin": "ethereum",
    "coinName": "Ethereum",
    "country": "au",
    "product": "staking-rewards",
    "rateLabel": "APY",
    "lastUpdated": "2026-03-04T04:00:00Z",
    "historyStartDate": "2026-02-02",
    "historyDays": 30,
    "items": [
      { "id": "lido", "name": "Lido", "slug": "lido", "color": "#00A3FF" },
      { "id": "rocketpool", "name": "Rocket Pool", "slug": "rocketpool", "color": "#FF6B35" }
    ]
  },
  "series": [
    { "date": "2026-03-03", "item": "lido", "rate": 3.82 },
    { "date": "2026-03-03", "item": "rocketpool", "rate": 3.55 },
    { "date": "2026-03-02", "item": "lido", "rate": 3.85 },
    { "date": "2026-03-02", "item": "rocketpool", "rate": 3.52 }
  ],
  "currentRates": {
    "lido": 3.82,
    "rocketpool": 3.55
  }
}

Query Parameters

Request Parameters

Field	Type	Description
`coin`	string	CoinGecko ID (e.g., bitcoin, ethereum) - for coin page queries
`platform`	string	Provider slug (e.g., nexo, lido) - for platform page queries
`country`required	string	ISO 2-letter country code (e.g., au, gb, us)
`product`required	string	Product: lending-rates, loan-rates, staking-rewards
`timeframe`	string	Time range: 30d, 90d, 1y, all (default: 30d)
`limit`	number	Max items to return (default: 6, max: 20)

Response Schema

Response includes metadata, time-series data points, and current rates.

Meta Object Fields

Field	Type	Description
`coin`	string	CoinGecko coin ID (for coin queries)
`platform`	string	Provider ID (for platform queries)
`country`required	string	ISO 2-letter country code
`product`required	string	Product slug: lending-rates, loan-rates, staking-rewards
`rateLabel`required	string	Rate display label (APY, APR)
`lastUpdated`required	string	ISO timestamp of last data update
`historyDays`required	number	Number of days of history available

Series Data Point Fields

Field	Type	Description
`date`required	string	ISO date string (YYYY-MM-DD)
`item`required	string	Provider or coin slug
`rate`required	number	Rate value at this point

Example Queries

ETH staking rates over 30 days (coin page)

GEThttps://api.bitcompare.net/v1/rates/history?coin=ethereum&country=au&product=staking-rewards&timeframe=30d

curl -X GET "https://api.bitcompare.net/v1/rates/history?coin=ethereum&country=au&product=staking-rewards&timeframe=30d" \
  -H "Accept: application/json"

All rates from Nexo over 90 days (platform page)

GEThttps://api.bitcompare.net/v1/rates/history?platform=nexo&country=gb&product=lending-rates&timeframe=90d

curl -X GET "https://api.bitcompare.net/v1/rates/history?platform=nexo&country=gb&product=lending-rates&timeframe=90d" \
  -H "Accept: application/json"

Loan rates for 1 year

GEThttps://api.bitcompare.net/v1/rates/history?coin=bitcoin&country=us&product=loan-rates&timeframe=1y

curl -X GET "https://api.bitcompare.net/v1/rates/history?coin=bitcoin&country=us&product=loan-rates&timeframe=1y" \
  -H "Accept: application/json"

Products

lending-rates — Lending/earn yields
loan-rates — Borrowing APR
staking-rewards — Staking APY

Timeframes

30d — Last 30 days (default)
90d — Last 90 days
1y — Last year
all — All available data

Symbol History Endpoint

Alternative endpoint for querying history by symbol with date range filters.

GEThttps://api.bitcompare.net/v1/rates/ETH/history?category=staking&from=2026-02-01&to=2026-03-01&limit=30

curl -X GET "https://api.bitcompare.net/v1/rates/ETH/history?category=staking&from=2026-02-01&to=2026-03-01&limit=30" \
  -H "Accept: application/json"

Related Endpoints

📊

Rates API

Current rate data

🥩

Staking Rates

Filter by category=staking

🪙

Stablecoin Index

Peg tracking & stability

Analyze Historical Trends

Get your API key and access years of rate history.

Get API Key View Documentation

Back to Pro Overview