Currency Exchange Rate API

By FinanceFlowAPI · Last reviewed November 11, 2026

← All financial data endpoints

Why Use FinanceFlowAPI’s Currency Exchange Rate API?

Most currency data providers either cap you to a handful of major pairs or split majors, crosses and exotics across different plans. The Currency Exchange Rate API normalizes 3,281 pairs, both directions of every pair (e.g. EUR/USD and USD/EUR independently), into one schema and one authentication method, so a new market or currency corridor is a parameter change, not a new integration.

• One JSON schema for every pair, no per-source parsing.
• 3,281 pairs across 155 currencies verified live against production, majors through exotics.
• A dedicated catalog endpoint to discover the exact pairs available for a currency, instead of guessing symbols.
• Same account, API key and billing as the rest of FinanceFlowAPI: Commodities, Bonds, Economic Calendar and Economic Indicators data.

Key Capabilities

• Full quote data: every response includes price, bid, ask, open, high, low, chg and chg_percent, so you get a tradeable spread and daily range in one call.
• Trading-session awareness: a trading_status field (open/close) tells you whether the quote reflects a live session or the last close, useful since FX trades roughly 24/5 and goes quiet on weekends.
• Query by exact pair or by currency: request one specific pair (pair=EUR/USD) or every pair involving a currency (currency=USD) from the same endpoint.
• Built-in discovery: currency-catalog lists every supported pair, optionally filtered by currency, so you never have to guess a symbol.

Data Coverage & Trust

Data Methodology

Currency Exchange Rate API data is aggregated from market data sources and normalized into one consistent quote schema (price, bid/ask, open/high/low, change and trading status) for every supported pair, so your integration doesn’t need a different parser per currency. Sourced from aggregated third-party market and statistical data providers; the specific vendor and full per-pair methodology are not published.

Request Example

GET https://financeflowapi.com/api/v1/currency-spot?api_key=YOUR_API_KEY&pair=EUR/USD

Response Example

{
  "success": true,
  "code": 200,
  "message": "OK",
  "meta": {
    "timestamp": 1787483995,
    "request_id": "6a8ad75b71af0"
  },
  "data": [
    {
      "pair": "EUR/USD",
      "price": "1.1677",
      "open": "1.1678",
      "bid": "1.1675",
      "ask": "1.1678",
      "high": "1.1712",
      "low": "1.1669",
      "chg": "-0.0001",
      "chg_percent": "-0.01",
      "trading_status": "close",
      "last_update": "2026-08-21"
    }
  ]
}

Note: this sample was captured over a weekend, when FX markets are closed, hence trading_status: "close" and a date-only last_update. During an active session, trading_status reads open and last_update includes a time, e.g. 2026-08-21 23:59:51.

API Parameters

currency-spot. Live quote for one pair, or every pair involving one currency:

currency-catalog. Discover available pairs:

Response Schema

currency-spot. Each item in data:

currency-catalog. Each item in data:

HTTP Status & Errors

Code Examples

curl "https://financeflowapi.com/api/v1/currency-spot?api_key=YOUR_API_KEY&pair=EUR/USD"

import requests

url = "https://financeflowapi.com/api/v1/currency-spot"
params = {
    "api_key": "YOUR_API_KEY",
    "pair": "EUR/USD"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

const params = new URLSearchParams({
  api_key: "YOUR_API_KEY",
  pair: "EUR/USD"
});

fetch(`https://financeflowapi.com/api/v1/currency-spot?${params}`)
  .then(res => res.json())
  .then(data => console.log(data));

<?php
$params = http_build_query([
    'api_key' => 'YOUR_API_KEY',
    'pair'    => 'EUR/USD',
]);

$response = file_get_contents("https://financeflowapi.com/api/v1/currency-spot?{$params}");
$data = json_decode($response, true);

print_r($data);

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    params := url.Values{}
    params.Add("api_key", "YOUR_API_KEY")
    params.Add("pair", "EUR/USD")

    resp, err := http.Get("https://financeflowapi.com/api/v1/currency-spot?" + params.Encode())
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)

    var data map[string]interface{}
    json.Unmarshal(body, &data)

    fmt.Println(data)
}

Use Cases

• Forex trading platforms. Power live rate widgets and trading signals with bid/ask spreads across 3,281 pairs.
• Multi-currency checkout & invoicing. Convert prices for international customers using real-time exchange rates instead of a stale daily fixing.
• Financial dashboards. Display exchange rates alongside Commodity Price API data for macro/FX context.
• Rate alert bots. Trigger notifications when a pair’s chg_percent crosses a threshold.

Who Is This API For?

• Forex traders and trading-bot developers who need live bid/ask quotes across majors and exotics
• Fintech and e-commerce platforms that need real-time currency conversion for global transactions
• Fintech dashboards pairing live FX rates with bond yields or commodity prices via the same api_key: one integration, multiple asset classes
• Publishers and content platforms that need sourced currency rate data

Limitations

• No historical/time-series data on this API for currencies: currency-spot returns only the latest quote plus intraday high/low/change, not a date-range history.
• pair and currency are mutually exclusive on currency-spot: supplying both returns a 400.
• pair/currency must match the catalog spelling exactly; there is no free-text or fuzzy search.
• Endpoint access and your per-minute rate limit depend on your subscription plan.

Related APIs

• Commodity Price API: live commodity prices alongside currency rates for cross-asset dashboards.
• Economic Indicators API: see how currency moves relate to inflation and other macro indicators.

Full API documentation →