Crypto Exchange Rates

Crypto Exchange Rates

Retrieve real-time and historical cryptocurrency exchange rates through REST, stream live over WebSocket, integrate with AI applications using CoinAPI MCP servers, or access the same functionality through JSON-RPC.

CoinAPI Exchange Rates provide standardized reference prices calculated using a rolling 24-hour Volume Weighted Average Price (VWAP-24H) across multiple data sources.

Explore the DocsGet Your API Key

What Are Crypto Exchange Rates?

An exchange rate represents the reference value between two assets.

Unlike trades, which reflect individual transactions, or quotes, which represent executable bid and ask prices from a single market, CoinAPI Exchange Rates are calculated as a rolling 24-hour Volume Weighted Average Price (VWAP-24H) across multiple data sources selected and managed by CoinAPI.

This approach provides a consistent reference price that is less dependent on activity from a single exchange and better reflects broader market conditions.

Exchange Rates are also useful when applications need to convert between many assets without managing every individual market pair directly. Developers can request a specific rate, retrieve all current rates for one base asset, or use historical timeseries data to support audits, reconciliations, trend analysis, and backtesting.

For trading execution, trades, quotes, or order books are usually more appropriate; for benchmark pricing, asset conversion, and financial records, Exchange Rates provide the cleaner reference layer.

Exchange Rates are commonly used for portfolio valuation, accounting, reporting, asset conversion, pricing dashboards, treasury systems, and AI applications that require a standardized market reference rather than executable market data.

What's Included?

Each exchange rate contains standardized asset identifiers, timestamps, and the calculated reference rate.

FieldWhat it means
timeTimestamp when the exchange rate was calculated
asset_id_baseBase asset identifier
asset_id_quoteQuote asset identifier
rateVWAP-24H exchange rate between the two assets
rate_type (WebSocket)Describes how the exchange rate was calculated

Historical timeseries responses additionally include:

FieldWhat it means
time_period_startBeginning of the requested period
time_period_endEnd of the requested period
time_openTimestamp of the opening rate
time_closeTimestamp of the closing rate
rate_openOpening exchange rate
rate_highHighest exchange rate during the period
rate_lowLowest exchange rate during the period
rate_closeClosing exchange rate

These fields allow developers to build conversion services, valuation engines, historical charts, reporting systems, and market analytics using a consistent pricing methodology.

Available REST Endpoints

CoinAPI provides separate REST APIs for real-time and historical exchange rates, supporting both single asset pairs and one-to-many asset conversions.

Get Current Exchange Rate

Returns the current VWAP-24H exchange rate for a specific asset pair.

Response includes
  • calculation timestamp
  • base asset
  • quote asset
  • current exchange rate

Returns the current rolling VWAP-24H reference rate. For mission-critical applications, compare the response timestamp with the current time to verify freshness. API key authentication is required.

Parameters:asset_id_base • asset_id_quote

Get All Current Exchange Rates

Returns the exchange rate between one base asset and multiple quote assets.

Response includes
  • base asset
  • collection of exchange rates
  • timestamps for each quote asset

Filter responses to specific quote assets using filter_asset_id, and invert rates using the invert parameter. API key authentication is required.

Parameters:asset_id_base • filter_asset_id • invert

Get Historical Exchange Rate

Returns the exchange rate for a specific asset pair at a chosen point in time.

Response includes
  • historical timestamp
  • base asset
  • quote asset
  • historical exchange rate

If no timestamp is provided, the current rate is returned. API key authentication is required.

Parameters:asset_id_base • asset_id_quote • time

Historical Exchange Rate Timeseries

Returns historical exchange rates as OHLC time series.

Response includes
  • period start and end
  • open, high, low, and close rates
  • opening and closing timestamps

Supported periods range from 1SEC to 10DAY. Extended gap filling can improve continuity around requested boundaries. Historical data supports configurable time windows and pagination.

Parameters:asset_id_base • asset_id_quote • period_id • time_start • time_end • limit • extended_gap_filling

Live Exchange Rate Streaming

CoinAPI WebSocket streams continuously updated VWAP-24H exchange rates through a persistent publish-subscribe connection. Unlike REST, which retrieves rates on demand, WebSocket pushes updated exchange rates as market conditions change.

Each message includes the asset pair, calculation timestamp, exchange rate, and rate type. Three calculation methods are supported:

Calculation methodWhat it means
BASE_QUOTE_ISOLATEDCalculated only from markets directly containing the requested asset pair.
BASE_ALL_CROSSES_TO_REFCalculated using multiple market crosses to determine the reference value. This is the standard rate available throughout CoinAPI.
BASE_AND_QUOTE_TO_REFDerives non-reference quote assets from reference asset calculations.

Because publishing every possible asset combination would be impractical, WebSocket streams reference rates quoted in USD. Other crosses can be derived client-side when needed (for example, BTC/USDC from BTC/USD and USD/USDC).

Base assetQuote assetExample
BTCUSDBTC/USD
ETHUSDETH/USD
SOLUSDSOL/USD
USDCUSDUSDC/USD
………

Heartbeat and reconnect messages are also available to help applications detect idle connections and perform graceful reconnections during infrastructure maintenance.

CoinAPI Exchange Rates Dataset Characteristics

  • Available through REST API, WebSocket API, JSON-RPC, and dedicated MCP servers for AI agents and MCP-compatible clients
  • Exchange rates are calculated as a rolling VWAP-24H across multiple data sources selected and managed by CoinAPI
  • Supports current rates, historical point-in-time rates, and historical OHLC exchange-rate timeseries
  • Historical timeseries support periods from 1SEC through 10DAY
  • Supports one-to-one and one-to-many asset conversions
  • Optional rate inversion using the invert parameter
  • Historical timeseries support optional extended gap filling
  • ISO 8601 UTC timestamps
  • Standardized CoinAPI asset identifiers
  • Metadata endpoints are available for discovering supported assets and asset icons

Why Developers Use Exchange Rates Instead of Trades or Quotes

Trades and quotes represent executable market activity from specific trading venues. Exchange Rates serve a different purpose.

Instead of reflecting the latest trade or the current bid and ask from a single exchange, CoinAPI Exchange Rates provide a standardized VWAP-24H reference price aggregated across multiple data sources. This makes them better suited for valuation, reporting, accounting, portfolio pricing, treasury systems, and applications that require a consistent market reference rather than executable pricing.

If you need…Use
Portfolio valuationExchange Rates
Currency conversionExchange Rates
Reference pricingExchange Rates
Historical rate chartsExchange Rates
Executed transactionsTrades
Best bid and askQuotes
Market depthOrder Books

Many production systems combine both datasets. Exchange Rates provide a consistent reference value, while Trades, Quotes, and Order Books supply the exchange-level market data needed for execution and market analysis.

Common Exchange Rate Use Cases

  • Portfolio valuation
  • Cryptocurrency price conversion
  • Treasury and accounting systems
  • Historical market analysis
  • Pricing dashboards
  • AI financial applications

Who Uses Crypto Exchange Rates?

  • Digital asset custodians
  • Fintech platforms
  • Accounting and treasury systems
  • Portfolio management platforms
  • Banks and financial institutions
  • AI and machine learning applications
Crypto Exchange Rates

Ready to Build with CoinAPI Exchange Rates?

Explore the Exchange Rates documentation to retrieve standardized VWAP-24H reference prices, historical exchange-rate timeseries, and live streaming rates through REST, WebSocket, JSON-RPC, or MCP.

As your application evolves, combine Exchange Rates with Metadata, Trades, Quotes, Order Books, OHLCV, and other CoinAPI datasets to build a complete cryptocurrency market data platform on top of the CoinAPI ecosystem.

Explore the Exchange Rates DocumentationGet Your API Key