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.

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.

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 page

Multi-currency checkout guide

Read the implementation guide for base-currency design, fallbacks, and pricing consistency across surfaces.

Open guide

Historical FX reporting tutorial

Follow a practical workflow for date-range retrieval, normalization, and reporting-ready storage.

Open tutorial

FX comparison page

See what product and finance teams should evaluate when choosing an FX API for pricing and reporting.

Open comparison

Create account View pricing Currency Exchange API page

Continue with connected pages

Currency Exchange API

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Open page

FX conversion docs

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Open page

Historical FX docs

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Open page

Multi-currency pricing solution

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Open page