Getting Started

Introduction

RateFlow API provides latest and historical currency exchange rates through a simple RESTful JSON API. Integrate current exchange rate data into your applications with just a few lines of code.

Key features:

  • 100+ supported currency codes
  • Historical exchange rates
  • Pair conversion with amount calculation
  • Enriched currency metadata (names, symbols)
  • Monthly quota tracking
  • Per-minute and monthly rate limiting with clear response headers

Base URL

All API v1 requests use the following base URL:

https://api.rateflow.com/v1/

{info} All requests must include a valid API key via the X-API-Key header. See Authentication for details.

How to Get an API Key

  1. Create a free account on RateFlow.
  2. Verify your email address.
  3. Go to your Dashboard.
  4. Navigate to API Keys.
  5. Click Create New Key and give it a name.
  6. Copy the key immediately — it will only be shown once.

{warning} Store your API key securely. Never expose it in client-side code, public repositories, or URLs.

Quick Start

Make your first API call to fetch the latest EUR exchange rates:

curl -s -H "X-API-Key: YOUR_API_KEY" "https://api.rateflow.com/v1/rates/latest?base=EUR"

Response:

{
    "success": true,
    "data": {
        "base": "EUR",
        "updated_at": "2026-03-29T15:00:00Z",
        "rates": {
            "USD": 1.0821,
            "GBP": 0.8569,
            "JPY": 162.45,
            "CHF": 0.9612
        }
    }
}

{info} Successful responses use a consistent { "success": true, "data": { ... } } envelope. Errors return "success": false with an error object instead.

See the full list of Endpoints and Code Examples for more.