Currencies API

Real-Time & Historical Exchange Rates for Fiat and Crypto Assets

Access real-time exchange rates, historical FX data, OHLC exchange-rate time series, asset metadata, and cryptocurrency pricing through one standardized API.

FinFeedAPI standardizes currency and cryptocurrency exchange rates behind a consistent developer interface available through REST, WebSocket, JSON-RPC, and hosted Model Context Protocol (MCP) servers. Instead of combining multiple pricing providers, historical datasets, streaming feeds, and metadata services, applications retrieve standardized exchange rate data through one platform with uniform schemas.

Start With Free CreditsView Documentation
RatesConnecting
Rates
FinFeedAPI Currencies · WebSocket
Real-Time + HistoricalExchange Rates
2Hosted MCP Servers
4Integration Protocols
100,000Max Limits OHLC Rows per Request

What Data Will You Get?

Real-Time Exchange Rates

Retrieve the latest exchange rate for a specific base and quote asset using 24-hour rolling VWAP values calculated across multiple managed market data sources.

Historical Exchange Rates

Retrieve historical exchange rates for any supported asset pair at a specific point in time using ISO 8601 timestamps.

Single-Pair Exchange Rates

Retrieve real-time and historical exchange rates for any base and quote asset pair. Rates are available through REST endpoints and reflect VWAP-based pricing.

One-to-Many Exchange Rates

Retrieve exchange rates from one base asset to multiple quote assets in a single request, reducing API calls and simplifying currency conversion workflows.

All Rates for One Base Asset

Get the current exchange rate between one base asset and all other supported assets. Responses can be filtered or inverted (invert=true) to match application requirements.

Exchange Rate OHLC Time-Series

Retrieve historical Open, High, Low, and Close exchange-rate data for supported asset pairs to power charts, analytics, and quantitative research.

Multiple Time Granularities

Query historical exchange-rate data using predefined periods ranging from 1 second (1SEC) to 10 days (10DAY).

VWAP-Based Exchange Rates

Exchange rates are calculated using a rolling 24-hour Volume Weighted Average Price (VWAP) methodology across multiple managed market data sources.

Exchange Rate Methodology

Transparent methodology details, including direct pair calculations (BASE_QUOTE_ISOLATED) and cross-asset reference methodologies (BASE_ALL_CROSSES_TO_REF).

Asset Metadata

Access standardized metadata for supported fiat currencies and cryptocurrencies, including identifiers, names, asset types, historical coverage, USD valuation fields, blockchain addresses, asset icons, and a downloadable Assets.csv file.

Global Coverage

Coverage

The Currencies API provides standardized exchange rates and reference data covering both traditional fiat currencies and cryptocurrencies through one consistent developer interface. All datasets follow the same standardized schemas, authentication model, timestamp conventions, and API design across REST, WebSocket, JSON-RPC, and hosted MCP interfaces.

DatasetExamples
Fiat CurrenciesUSD, EUR, GBP, JPY, CHF, AUD, CAD and other ISO 4217 currencies
CryptocurrenciesBTC, ETH, XRP and thousands of supported digital assets
Real-Time RatesCurrent VWAP-24H exchange rates for individual asset pairs or one-to-many conversions
Historical RatesPoint-in-time exchange rates for any supported timestamp
Historical OHLCExchange-rate candles from 1SEC through 10DAY periods
Reference DataAsset metadata, blockchain addresses (where applicable), asset icons and downloadable Assets.csv
Unique Dataset

Exchange Rate OHLC Time-Series Built for Historical Analysis

Most exchange rate APIs return the latest price or a historical rate for a specific timestamp.

FinFeedAPI also provides OHLC (Open, High, Low, Close) exchange-rate time-series, making historical currency analysis significantly easier. Instead of collecting thousands of individual exchange rate observations and generating candles manually, applications can retrieve ready-to-use OHLC data across predefined intervals ranging from 1 second to 10 days.

OHLC time-series reveal how exchange rates moved throughout each period, not just where they finished. This provides far richer historical context for charting, trend analysis, reporting, quantitative research, and AI training datasets than standalone exchange-rate snapshots.

By delivering standardized exchange-rate candles through the same API used for real-time rates and historical snapshots, FinFeedAPI eliminates the need to build and maintain a separate aggregation pipeline for historical currency data.

AI Applications

Built for AI Applications with MCP

The Currencies API is available through two hosted Model Context Protocol (MCP) servers, giving AI assistants and agentic applications direct access to both real-time and historical exchange rate data through standardized tool calls. Instead of building custom REST integrations, parsing API documentation, or maintaining intermediary services, AI applications can discover available tools automatically through MCP. Every tool is self-describing through JSON Schema, allowing Large Language Models to understand available parameters, validate requests, and retrieve structured financial data with minimal implementation effort.

Real-Time Exchange Rates MCP Configuration

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

Historical Exchange Rates MCP Configuration

json
{
  "mcpServers": {
    "FinFeedAPI-Currencies-Historical": {
      "url": "https://api-historical.fx.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}
  • Native Hosted MCP Servers: Maintained directly by FinFeedAPI at /mcp endpoints.
  • Standard Authentication: X-APIKey header authentication across both MCP servers.
  • Self-Describing Tools: Automatic discovery through JSON Schema definitions.
  • Direct Protocol Access: Instant access to real-time rates, historical snapshots, OHLC time series, metadata, icons, and reference datasets.
  • Predictable Formatting: Structured snake_case JSON responses across all tool definitions.
  • Tool Compatibility: Fully compatible with Cursor, Claude Desktop, and any MCP-enabled AI application.
Protocols & Interfaces

Multiple Access Protocols

Choose the interface that best fits your application architecture. All interfaces expose the same standardized exchange-rate datasets while using consistent asset identifiers, timestamps, and response formats where applicable.

InterfaceBest ForEndpoint / Target
REST API (Real-Time)Request-response real-time rates & metadatahttps://api-realtime.fx.finfeedapi.com
REST API (Historical)Point-in-time rates, periods, and OHLC historyhttps://api-historical.fx.finfeedapi.com
WebSocket APIStreaming real-time FX & crypto updateswss://api-realtime.fx.finfeedapi.com
JSON-RPC APIRPC requests proxied over REST paths/jsonrpc endpoint on Realtime/Historical hosts
Hosted MCP ServerAI agents, LLMs, and MCP-compatible developer tools/mcp endpoint on Realtime/Historical hosts
Platform Specifications

Engineering Standards

Built for production environments where consistency matters:

ISO 8601 UTC Timestamps

Standardized UTC date and time formatting across all requests and responses.

Consistent Data Model

Uniform asset identifiers, exchange-rate schemas, and response structures across real-time rates, historical snapshots, OHLC time series, and metadata.

Strict snake_case Conventions

Predictable field naming across JSON properties, JSON-RPC methods, and MCP tool parameters.

Unified Key Management

Single key provisioning for access across REST, WebSocket, JSON-RPC, and MCP interfaces.

Official Open-Source SDKs

Libraries for Python, R, Matlab, C#, C++, .NET, Java, Ruby, Go, JavaScript, TypeScript, Node.js, PHP, Haskell, Objective-C, and Swift maintained in the api-bricks GitHub repository.

Competitive Advantage

FinFeedAPI vs Direct Integrations

Building reliable exchange rate infrastructure requires much more than calling a single API. Many applications combine separate providers for cryptocurrency prices, fiat exchange rates, historical datasets, streaming updates, metadata, and asset reference information. Each service introduces different authentication methods, schemas, timestamp formats, identifiers, and update frequencies that increase engineering complexity over time.

FeatureDirect IntegrationsFinFeedAPI Currencies API
AuthenticationDifferent API keys for multiple providersStandardized authentication model
Data SourcesSeparate providers for fiat, crypto, metadata, and historyOne unified Currencies API
Exchange RatesCurrent rates only or provider-specific implementationsReal-time, historical, and OHLC exchange rates
Historical DataDifferent endpoints, formats, and aggregation methodsStandardized historical snapshots & OHLC time-series
Asset MetadataSeparate reference datasets and custom mappingIntegrated metadata, icons, and downloadable Assets.csv
Data FormatsDifferent JSON schemas per providerConsistent JSON responses
TimestampsMixed timezone and timestamp formats100% ISO 8601 UTC
Naming ConventionsMixed camelCase, snake_case, and PascalCaseStrict snake_case properties
AI CompatibilityRequires custom API wrappers for LLM function callingNative hosted MCP servers with self-describing schemas
Access MethodsVaries by providerREST • WebSocket • JSON-RPC • MCP
Onboarding

Quickstart

Start retrieving exchange rates in just a few minutes.

  1. 1Create your free FinFeedAPI account.
  2. 2Generate an API key.
  3. 3Choose REST, WebSocket, JSON-RPC, or MCP.
  4. 4Request your first exchange rate or historical dataset.
  5. 5Integrate the same API across your applications.

Explore the documentation for endpoint examples, SDKs, authentication, and supported assets.

Example: Retrieve Historical OHLC Exchange-Rate Data

Retrieve daily OHLC exchange-rate candles for the BTC/USD currency pair:

bash
curl -X GET "https://api-historical.fx.finfeedapi.com/v1/exchangerate/BTC/USD/history?period_id=1DAY&time_start=2026-01-01T00:00:00Z&time_end=2026-01-31T00:00:00Z&limit=30" \
  -H "Authorization: YOUR_API_KEY"

The API returns standardized OHLC exchange-rate candles with ISO 8601 UTC timestamps, consistent snake_case fields, and the same response format used across all historical datasets.

The Challenge

Currency Data Comes From Many Different Sources

Applications often need much more than the latest exchange rate.

They require historical prices for analytics, OHLC time series for charting, metadata for supported assets, icons for user interfaces, streaming updates for live applications, and consistent identifiers across fiat currencies and cryptocurrencies.

Building this infrastructure usually means integrating multiple providers, normalizing different schemas, handling separate authentication methods, and maintaining several independent services.

One Standardized Platform

FinFeedAPI solves this by delivering exchange rates, historical data, metadata, asset icons, and streaming updates through one standardized platform with consistent APIs, documentation, SDKs, and developer workflows.

Use Cases

Common Applications

  • Currency conversion services
  • Financial dashboards
  • Portfolio valuation
  • Treasury and accounting systems
  • Payment platforms
  • Multi-currency applications
  • AI agents and LLM tools
  • Historical FX analysis
  • Market research
  • Trading and analytics platforms

Start Building

Access standardized real-time exchange rates, historical currency data, OHLC time series, asset metadata, and streaming updates through a single developer platform.

Whether you're building financial software, payment infrastructure, AI applications, or analytics platforms, FinFeedAPI provides the exchange rate data your applications need through one consistent API.

Start With Free CreditsTalk to Sales