Key points
- Supports latest rates, historical lookups, and conversion-style workflows.
- Base currency and symbol filtering keep responses focused.
- The JSON shape works well for pricing services, dashboards, and reporting jobs.
Updated on 2026-05-12
NovaDataHub Engineering
Developer docs
Currency Exchange API Documentation
The Currency Exchange API returns latest rates, time-series history, and direct conversion data in structured JSON for pricing, reporting, and finance workflows.
Common errors
- 400 invalid_currency
- 401 invalid_key
- 429 rate_limited
- 500 data_source_failed
Reference details
Parameters, response shape, and operational notes
Parameter notes
- base and symbols are the most common parameters on rates endpoints.
- Historical workflows should preserve date-range inputs alongside the returned values.
- Conversion workflows should keep both the original amount and returned rate for downstream traceability.
Response highlights
- Look for base, date, rates, and result fields depending on the endpoint family.
- Historical responses are most useful when stored with the request context that produced them.
- Conversion responses are often passed directly into pricing or checkout logic.
Operational notes
- Separate current-rate fetches from historical-reporting jobs so the calling pattern stays clear.
- Cache or schedule rate retrieval in a way that matches how fast the product actually needs new values.
- Preserve the base currency in stored records so later reporting remains interpretable.
Implementation checklist
- Start with a latest-rates request before introducing historical or conversion flows.
- Choose whether your first integration target is pricing, reporting, or reconciliation so the storage model stays clean.
- Add validation around supported currency inputs before exposing conversions to end users.
Code examples
Visible integration examples
curl
curl -s -H "x-api-key: YOUR_API_KEY" "https://novadatahub.com/api/fx/rates?base=USD&symbols=EUR,INR,GBP"Python
import requests
url = 'https://novadatahub.com/api/fx/rates'
params = {'base': 'USD', 'symbols': 'EUR,INR,GBP'}
resp = requests.get(url, params=params, headers={'x-api-key': 'YOUR_API_KEY'}, timeout=60)
print(resp.json())C# HttpClient
using System.Net.Http.Json;
using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var json = await http.GetFromJsonAsync<JsonElement>("https://novadatahub.com/api/fx/rates?base=USD&symbols=EUR,INR,GBP");
Console.WriteLine(json.ToString());Sample JSON response
{
"ok": true,
"base": "USD",
"date": "2026-05-11",
"rates": {
"EUR": 0.92,
"INR": 83.2,
"GBP": 0.78
}
}Related resources
Move from reference docs into the next relevant workflow
Currency Exchange API landing page
Open the main FX overview page for current rates, conversion, and historical data use cases.
Open landing pageFX response fields
Map base, date, rates, conversion values, and time-series structures into cleaner downstream models.
Open docsAPI playground workflow
Validate rate, conversion, or historical requests before wiring pricing, checkout, or reporting logic.
Open docsMulti-currency checkout guide
Read the implementation guide for base-currency design, fallbacks, and pricing consistency across surfaces.
Open guideHistorical FX reporting tutorial
Follow a practical workflow for date-range retrieval, normalization, and reporting-ready storage.
Open tutorialFX comparison page
See what product and finance teams should evaluate when choosing an FX API for pricing and reporting.
Open comparisonRelated links