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.
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.
Real-Time + HistoricalExchange Rates
2Hosted MCP Servers
4Integration Protocols
100,000Max Limits OHLC Rows per Request
What Data Will You Get?
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.
| Dataset | Examples |
|---|---|
| Fiat Currencies | USD, EUR, GBP, JPY, CHF, AUD, CAD and other ISO 4217 currencies |
| Cryptocurrencies | BTC, ETH, XRP and thousands of supported digital assets |
| Real-Time Rates | Current VWAP-24H exchange rates for individual asset pairs or one-to-many conversions |
| Historical Rates | Point-in-time exchange rates for any supported timestamp |
| Historical OHLC | Exchange-rate candles from 1SEC through 10DAY periods |
| Reference Data | Asset 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.
| Interface | Best For | Endpoint / Target |
|---|---|---|
| REST API (Real-Time) | Request-response real-time rates & metadata | https://api-realtime.fx.finfeedapi.com |
| REST API (Historical) | Point-in-time rates, periods, and OHLC history | https://api-historical.fx.finfeedapi.com |
| WebSocket API | Streaming real-time FX & crypto updates | wss://api-realtime.fx.finfeedapi.com |
| JSON-RPC API | RPC requests proxied over REST paths | /jsonrpc endpoint on Realtime/Historical hosts |
| Hosted MCP Server | AI 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.
| Feature | Direct Integrations | FinFeedAPI Currencies API |
|---|---|---|
| Authentication | Different API keys for multiple providers | Standardized authentication model |
| Data Sources | Separate providers for fiat, crypto, metadata, and history | One unified Currencies API |
| Exchange Rates | Current rates only or provider-specific implementations | Real-time, historical, and OHLC exchange rates |
| Historical Data | Different endpoints, formats, and aggregation methods | Standardized historical snapshots & OHLC time-series |
| Asset Metadata | Separate reference datasets and custom mapping | Integrated metadata, icons, and downloadable Assets.csv |
| Data Formats | Different JSON schemas per provider | Consistent JSON responses |
| Timestamps | Mixed timezone and timestamp formats | 100% ISO 8601 UTC |
| Naming Conventions | Mixed camelCase, snake_case, and PascalCase | Strict snake_case properties |
| AI Compatibility | Requires custom API wrappers for LLM function calling | Native hosted MCP servers with self-describing schemas |
| Access Methods | Varies by provider | REST • WebSocket • JSON-RPC • MCP |
Onboarding
Quickstart
Start retrieving exchange rates in just a few minutes.
- 1Create your free FinFeedAPI account.
- 2Generate an API key.
- 3Choose REST, WebSocket, JSON-RPC, or MCP.
- 4Request your first exchange rate or historical dataset.
- 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.
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.