Currency Exchange Rate API

← 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 628 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.
• 628 pairs across 127 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.

Live API Playground Coming Soon

An interactive API Playground for this endpoint is planned. Until it ships, use the request and response examples below, or your own HTTP client, to try the API live with your key.

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 628 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 →