Currency Service (Specs)

The Currency Service provides cross-border foreign exchange rate discovery across major developed and emerging market currencies. It enables enterprise platforms, treasury dashboards, and checkout systems to fetch multi-pair exchange rates in a single request.

flowchart TD
    subgraph Client["Client Application"]
        Request["POST /fx/bulk-exchange-rates"]
        Display["Dashboard / Rate Board"]
    end

    subgraph CurrencyService["Currency Service Engine"]
        Validator["Validate Currency Pairs"]
        PricingEngine["Real-Time FX Liquidity Aggregator"]
    end

    subgraph Markets["Global FX Liquidity Rails"]
        Majors["Developed Markets (USD, EUR, GBP, JPY)"]
        Emerging["Emerging Markets (NGN, KES, ZAR, AED, INR)"]
    end

    Request --> Validator
    Validator --> PricingEngine
    PricingEngine --> Majors
    PricingEngine --> Emerging
    Majors --> PricingEngine
    Emerging --> PricingEngine
    PricingEngine -.->|Aggregated Rates Array| Display

---

Key Capabilities

• Multi-Pair Batch Discovery: Request exchange rates for multiple currency pairs simultaneously, reducing network latency for rate boards and multi-currency checkout interfaces.
• Fetch All Option: Pass ?fetchAll=true with an empty payload to instantly retrieve all supported global currency pairs.
• Global Coverage: Unified access to developed currencies (USD, GBP, EUR, CAD, CHF, JPY) and emerging market liquidity.

[!NOTE] This endpoint is part of the Currency Specs API. For trade execution with rate-locking quote tokens (vfx_token), refer to the Atlas Exchange Service.

---

Available Endpoints

Endpoint	Method	Operation ID	Description
/fx/bulk-exchange-rates	POST	get_bulk_exchange_rates	Retrieve FX rates for multiple currency pairs in one batch request

---

Authentication

Authentication is performed using a JWT Bearer token:

Authorization: Bearer <your_jwt_access_token>