Currency Exchange Rates

Currency Rates

FinFeedAPI Currency Exchange Rates provide standardized reference exchange rates for global fiat currencies and digital assets, calculated as a rolling 24-hour Volume Weighted Average Price (VWAP-24H) across multiple data sources.

The dataset includes current exchange rates, historical point-in-time rates, and historical exchange rate time series for currency conversion, valuation, treasury operations, financial reporting, historical FX analysis, and other applications that depend on consistent reference pricing.

Explore the DocumentationGet Your API Key

What Are Currency Exchange Rates?

An exchange rate represents the reference value between two assets.

For fiat currencies, exchange rates are used to convert one currency into another. For digital assets, they provide a standardized reference price that allows applications to value cryptocurrencies alongside traditional currencies using the same interface.

Rather than reflecting the latest transaction from a single market, FinFeedAPI Exchange Rates are calculated as a rolling 24-hour Volume Weighted Average Price (VWAP-24H) across multiple data sources. The contributing sources are selected and managed by FinFeedAPI to provide consistent reference pricing.

This approach produces a stable reference rate that is less influenced by activity on any individual venue and better represents the broader market.

Exchange Rates are particularly useful when applications need to convert between many currencies without maintaining individual market relationships. Developers can retrieve the latest rate for a single currency pair, request one-to-many conversions from a single base asset, query historical rates at specific timestamps, or analyze historical exchange-rate time series.

Exchange Rates are designed for reference pricing rather than execution. Applications commonly use them for currency conversion, portfolio valuation, accounting, treasury operations, reporting, reconciliation, financial dashboards, historical analysis, and AI systems that require standardized market reference data instead of executable prices.

Why Use Exchange Rates Instead of Trades or Quotes?

Trades and quotes are designed for market execution. Exchange rates are designed for reference pricing. A trade records the price of a completed transaction, while a quote represents the current bid and ask available on a specific market. These datasets reflect market activity and are primarily used for trading systems.

Exchange Rates serve a different purpose. FinFeedAPI Exchange Rates provide a standardized reference value calculated as a rolling 24-hour VWAP across multiple data sources.

If your application needs to analyze market activity or execute trades, Trades, Quotes, and Order Books are more appropriate datasets.

If you need…Use
Currency conversionExchange Rates
Reference pricingExchange Rates
Financial reportingExchange Rates
Portfolio valuationExchange Rates
Historical FX chartsExchange Rates
Executed transactionsTrades
Best bid and ask pricesQuotes
Market depthOrder Books

Many financial systems combine both datasets: Exchange Rates provide the reference price for valuation and reporting, while market data supplies the venue-specific prices needed for execution.

What's Included in Currency Exchange Rates?

Each exchange rate contains standardized asset identifiers, timestamps, and the calculated reference exchange rate. Together, these fields support currency conversion services, valuation engines, historical charting, treasury systems, accounting workflows, financial reporting, and quantitative analysis using a consistent pricing methodology across fiat currencies and digital assets.

Current Exchange Rates

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

Timeseries responses 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

Available REST Endpoints

The Currency Exchange Rates dataset is available through separate REST APIs for current and historical exchange rates. Together, they support current pricing, historical snapshots, one-to-many conversions, and historical exchange rate time series.

Get Current Exchange Rate

Returns the current VWAP-24H exchange rate for a specific base and quote asset.

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

The returned rate represents the latest rolling VWAP-24H reference value calculated across multiple data sources. For applications that depend on the latest available pricing, FinFeedAPI recommends comparing the response timestamp with the current system time to verify that the data meets your freshness requirements. API key authentication is required.

Parameters:asset_id_base • asset_id_quote

Get All Current Exchange Rates

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

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

This endpoint is useful when pricing a single currency against many others without issuing multiple requests. Responses can be filtered to selected quote currencies using filter_asset_id, and reciprocal exchange rates can be returned 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 currency pair at a chosen point in time.

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

Historical snapshots allow applications to reconstruct exchange rates used at a previous moment for reporting, auditing, reconciliation, portfolio valuation, or financial analysis. If no timestamp is provided, the current exchange 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
  • opening and closing timestamps
  • open, high, low, and close exchange rates

Historical timeseries support granularities ranging from 1SEC to 10DAY. Time windows, response size, and optional extended gap filling can be configured through request parameters. API key authentication is required.

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

Live Exchange Rate Streaming

The Currency Exchange Rates dataset is also available through the FinFeedAPI WebSocket API, which continuously streams updated exchange rates over a persistent publish-subscribe connection.

WebSocket updates

Unlike REST APIs, where each request retrieves the latest available rate, WebSocket delivers exchange rate updates automatically as reference prices change. This reduces request overhead and allows applications to maintain continuously updated pricing with minimal latency.

Each exchange rate message includes the base asset, quote asset, calculation timestamp, exchange rate, and rate calculation method. Three exchange rate calculation methods are supported:

Calculation MethodWhat it means
BASE_QUOTE_ISOLATEDCalculated only from markets directly containing the requested currency pair.
BASE_ALL_CROSSES_TO_REFCalculates the reference value using multiple market crosses across available data sources. This is the standard exchange rate used throughout the FinFeedAPI platform.
BASE_AND_QUOTE_TO_REFDerives non-reference quote currencies from internally calculated reference rates.

Because publishing every possible currency combination would be impractical, the stream publishes reference rates quoted in USD. Applications requiring other currency pairs can derive them locally using the streamed reference rates.

Base AssetQuote AssetExample
EURUSDEUR/USD
GBPUSDGBP/USD
BTCUSDBTC/USD
ETHUSDETH/USD
………

Heartbeat messages can be enabled to detect idle connections, while reconnect messages allow clients to perform graceful reconnections during scheduled infrastructure maintenance without interrupting long-running applications.

MCP & JSON-RPC

The Currency Exchange Rates dataset is also available through FinFeedAPI MCP servers and JSON-RPC APIs, providing additional integration options beyond REST and WebSocket.

MCP Server

Hosted Currencies MCP servers let AI agents and MCP-compatible clients retrieve current exchange rates, historical exchange rates, exchange rate time series, and currency metadata using the same underlying dataset. Authentication uses the X-APIKey header. Realtime tools include exchange_rates_get_rate and exchange_rates_get_all_rates. Historical tools include exchange_rates_history_get_rate, exchange_rates_history_get_all_rates, and exchange_rates_history_get_timeseries.

json
{
  "mcpServers": {
    "FinFeedAPI-Currencies-Realtime": {
      "url": "https://api-realtime.fx.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}
json
{
  "mcpServers": {
    "FinFeedAPI-Currencies-Historical": {
      "url": "https://api-historical.fx.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Compatible with Cursor, Claude Desktop, and other MCP-enabled AI applications.

JSON-RPC

Developers using JSON-RPC can access exchange rates through https://api-realtime.fx.finfeedapi.com/jsonrpc and https://api-historical.fx.finfeedapi.com/jsonrpc.

JSON-RPC exposes the same functionality as the REST API while preserving the same authentication model, request parameters, and response structures. Set method to the REST path, for example v1/exchangerate/{asset_id_base}/{asset_id_quote} or v1/exchangerate/{asset_id_base}/{asset_id_quote}/history, and pass parameters through params. Successful JSON-RPC requests return the underlying REST payload in the result field.

Currency 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 24-hour VWAP across multiple data sources selected and managed by FinFeedAPI
  • Supports current exchange rates, historical point-in-time rates, and historical OHLC exchange-rate time series
  • Historical timeseries support periods from 1SEC through 10DAY
  • Supports one-to-one and one-to-many currency conversions
  • Optional reciprocal rate calculation using the invert parameter
  • Historical timeseries support optional extended gap filling
  • ISO 8601 timestamps throughout the dataset
  • Standardized asset identifiers for fiat currencies and digital assets
  • Metadata endpoints provide supported assets and asset icons for application discovery and UI development

Common Exchange Rate Use Cases

  • Currency conversion services
  • International payment platforms
  • Treasury management systems
  • Accounting and financial reporting
  • Portfolio valuation
  • ERP and business software
  • Historical FX analysis

Who Uses Currency Exchange Rates?

  • Banks
  • Fintech companies
  • Payment providers
  • Treasury teams
  • Accounting platforms
  • ERP vendors
  • Portfolio management platforms
Currency Exchange Rates

Ready to Build with FinFeedAPI Currencies API?

Explore the Currency API documentation to retrieve standardized reference exchange rates, historical FX time series, and live exchange rate updates through REST APIs, WebSocket, JSON-RPC, and MCP.

As your application grows, combine Exchange Rates with other FinFeedAPI datasets through a single integration to build a complete financial data platform.

Explore the DocumentationGet Your API Key