Updated on 2026-05-12 NovaDataHub Engineering

Currency Exchange API

Realtime exchange rates, historical time series, and instant currency conversion — three focused endpoints returning compact, consistent JSON for dashboards, ETL pipelines, and financial applications. All use the same x-api-key authentication.

Authentication

Pass your service API key in the x-api-key HTTP header. Obtain your key from the Dashboard after enabling Currency Exchange.

x-api-key: YOUR_API_KEY

🧪

New to APIs? Test this instantly — no tools needed.

After enabling Currency Exchange on the Dashboard, click the Playground button next to your key. Enter a base currency and target symbols, click Run request, and see live exchange rates in the browser.

Endpoints

Latest rates

GET /api/fx/rates

Historical time series

GET /api/fx/timeseries

Convert an amount

GET /api/fx/convert

Query parameters

GET /api/fx/rates — latest exchange rates

base string — Base currency (ISO 4217). Default: EUR
symbols string — Comma-separated target currencies. e.g. USD,INR,GBP. Omit for all available.

GET /api/fx/timeseries — historical date range

base string — Base currency. Default: EUR
symbols string — Comma-separated target currencies.
start string — Start date (YYYY-MM-DD).
end string — End date (YYYY-MM-DD).

GET /api/fx/convert — instant conversion

from string — Source currency. e.g. USD
to string — Target currency. e.g. INR
amount decimal — Amount to convert. Default: 1

Response fields — /rates & /timeseries

ok base date rates.{CURRENCY: value}

Response fields — /convert

ok from to amount rate result date

Sample responses

/api/fx/rates

{
  "ok": true,
  "base": "USD",
  "date": "2025-01-15",
  "rates": {
    "EUR": 0.9215,
    "INR": 83.21,
    "GBP": 0.7842
  }
}

/api/fx/convert

{
  "ok": true,
  "from": "USD",
  "to": "INR",
  "amount": 100,
  "rate": 83.21,
  "result": 8321.0,
  "date": "2025-01-15"
}

Error responses

HTTP	error	Meaning
401	`invalid_key`	API key missing or invalid.
400	`from and to are required`	Required params omitted on /convert.
400	`rate not found for {CUR}`	Currency symbol not supported or unavailable.
500	`data_source_failed`	Internal data source error.

cURL examples

Latest rates — USD base, selected symbols

curl -s -H "x-api-key: YOUR_API_KEY" \
  "https://novadatahub.com/api/fx/rates?base=USD&symbols=EUR,INR,GBP"

Historical time series — EUR/USD for a full year

curl -s -H "x-api-key: YOUR_API_KEY" \
  "https://novadatahub.com/api/fx/timeseries?base=EUR&symbols=USD&start=2024-01-01&end=2024-12-31"

Convert 100 USD to INR

curl -s -H "x-api-key: YOUR_API_KEY" \
  "https://novadatahub.com/api/fx/convert?from=USD&to=INR&amount=100"

Postman guide

Open Postman → New → HTTP Request.
Set method to GET. URL: https://novadatahub.com/api/fx/rates
Headers tab → add row — Key: x-api-key / Value: YOUR_API_KEY
Params tab → add: base=USD symbols=EUR,INR,GBP
Click Send. For conversion, switch URL to /api/fx/convert and use params from, to, amount instead.

C# HttpClient — convert 100 USD to INR

using System.Net.Http.Json;
using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var result = await http.GetFromJsonAsync<JsonElement>(
    "https://novadatahub.com/api/fx/convert?from=USD&to=INR&amount=100");

var rate   = result.GetProperty("rate").GetDecimal();
var output = result.GetProperty("result").GetDecimal();
Console.WriteLine($"1 USD = {rate} INR  |  100 USD = {output} INR");

C# HttpClient — fetch latest rates

using System.Net.Http.Json;
using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var rates = await http.GetFromJsonAsync<JsonElement>(
    "https://novadatahub.com/api/fx/rates?base=USD&symbols=EUR,INR,GBP");

foreach (var rate in rates.GetProperty("rates").EnumerateObject())
    Console.WriteLine($"{rate.Name}: {rate.Value.GetDecimal()}");

Popular workflows

Use-case pages for this API

Exchange rate API

Fetch current rates for reporting, product pricing, and global finance workflows.

Open use case

Currency conversion API

Convert amounts directly inside quoting, billing, and multi-currency UX flows.

Open use case

Historical exchange rate API

Retrieve time-series currency data for analytics, reporting, and reconciliation work.

Open use case

Pages that support FX buyers and implementers

Currency Exchange API landing page

A commercial overview page for rates, conversion, and historical FX data in structured JSON.

Open landing page

FX workflow use cases

Explore pages for exchange rates, conversion, historical data, fintech, and multi-currency pricing.

Open use cases

Best API for multi-currency pricing

Compare the buying criteria for checkout conversions, pricing logic, and historical-reporting support.

Open comparison

Developer docs

Use the docs hub for shared onboarding patterns, error handling, and code examples.

Open docs

Endpoint detail

Long-tail docs for conversion and historical FX workflows

FX buyers and implementers often search for very specific tasks rather than a generic currency API. Some teams need direct amount conversion for quoting and checkout flows, while others need historical time-series data for finance reporting or reconciliation. The public docs now split those tasks into narrower pages so the site can rank for more specific developer intent.

FX conversion endpoint

See how to use from, to, and amount for direct converted-value workflows.

Open endpoint docs

Historical FX time series

Read the time-series page for date ranges, symbol filtering, and reporting-oriented historical retrieval.

Open endpoint docs

Invalid API key debugging

Use the auth troubleshooting guide when environment configuration or service-key selection causes avoidable 401 errors.

Open guide

Multi-currency checkout logic

Read the checkout guide for base-currency design, fallback handling, rounding consistency, and audit-ready conversion context.

Open guide

Historical FX reporting workflows

Use the reporting guide for period-aware time-series handling, normalization, and finance-oriented downstream workflows.

Open guide

Historical FX reporting tutorial

Follow a concrete workflow for turning historical FX responses into reporting-ready rows and period-aware outputs.

Open tutorial

Continue with connected pages

All APIs

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

Open page

Documentation hub

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

Open page

Solutions

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

Open page

Tutorials

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

Open page