Referenz
Codebeispiele
Auf dieser Seite
Jedes Beispiel unten ist ein vollständiges Programm in cURL, PHP, JavaScript, Python, Rust, Go und C#. Wählen Sie über einem beliebigen Beispiel eine Sprache in den Reitern. Danach zeigen alle Beispiele auf der Seite diese Sprache, und die Dokumentation merkt sich Ihre Wahl für den nächsten Besuch.
Vorbereitung
Die Beispiele lesen Ihren API-Schlüssel aus der Umgebungsvariable RATEFLOW_API_KEY. So steht der Schlüssel nie in Ihrem Code:
export RATEFLOW_API_KEY="ihr-api-schluessel"
Erfolgreiche Antworten verwenden die Hülle { "success": true, "data": { ... } }, die Werte liegen also unter data. Fehler verwenden { "success": false, "error": { ... } }. Jedes Beispiel prüft den HTTP-Status. Bei einem Fehler gibt es den HTTP-Status, den Fehler-code und das Feld detail aus (siehe Fehler).
Was jede Sprache braucht:
- cURL: Version 7.76 oder neuer, wegen
--fail-with-body. - JavaScript: Node.js 18 oder neuer. Speichern Sie den Code als
.mjs-Datei, weil erawaitauf oberster Ebene verwendet. - Python: das Paket
requests(pip install requests). - Rust: diese Abhängigkeiten in
Cargo.toml:
[dependencies]
reqwest = { version = "0.12", features = ["blocking", "json"] }
serde = { version = "1", features = ["derive"] }
serde_json = "1"
Aktuelle Kurse
Das Beispiel ruft die neuesten EUR-Kurse ab und gibt den Kurs für USD aus.
curl -sS --fail-with-body \
-H "X-API-Key: $RATEFLOW_API_KEY" \
"https://api.rateflowapi.com/v1/rates/latest?base=EUR"
<?php
$ch = curl_init('https://api.rateflowapi.com/v1/rates/latest?base=EUR');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('RATEFLOW_API_KEY')],
]);
$body = json_decode((string) curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status !== 200) {
fwrite(STDERR, "{$status} {$body['error']['code']}: {$body['error']['detail']}" . PHP_EOL);
exit(1);
}
echo "EUR zu USD am {$body['data']['date']}: {$body['data']['rates']['USD']}" . PHP_EOL;
const response = await fetch('https://api.rateflowapi.com/v1/rates/latest?base=EUR', {
headers: { 'X-API-Key': process.env.RATEFLOW_API_KEY },
});
const body = await response.json();
if (!response.ok) {
throw new Error(`${response.status} ${body.error.code}: ${body.error.detail}`);
}
console.log(`EUR zu USD am ${body.data.date}: ${body.data.rates.USD}`);
import os
import requests
response = requests.get(
"https://api.rateflowapi.com/v1/rates/latest",
params={"base": "EUR"},
headers={"X-API-Key": os.environ["RATEFLOW_API_KEY"]},
timeout=10,
)
body = response.json()
if not response.ok:
raise SystemExit(f"{response.status_code} {body['error']['code']}: {body['error']['detail']}")
print(f"EUR zu USD am {body['data']['date']}: {body['data']['rates']['USD']}")
use serde::{de::DeserializeOwned, Deserialize};
use std::{collections::BTreeMap, env, error::Error};
#[derive(Deserialize)]
struct Success<T> {
data: T,
}
#[derive(Deserialize)]
struct Failure {
error: ApiError,
}
#[derive(Deserialize)]
struct ApiError {
code: String,
detail: String,
}
#[derive(Deserialize)]
struct Latest {
date: String,
rates: BTreeMap<String, f64>,
}
fn get<T: DeserializeOwned>(path: &str) -> Result<T, Box<dyn Error>> {
let response = reqwest::blocking::Client::new()
.get(format!("https://api.rateflowapi.com/v1{path}"))
.header("X-API-Key", env::var("RATEFLOW_API_KEY")?)
.send()?;
let status = response.status();
if status.is_success() {
return Ok(response.json::<Success<T>>()?.data);
}
let body = response.text()?;
let message = match serde_json::from_str::<Failure>(&body) {
Ok(failure) => format!("{} {}: {}", status.as_u16(), failure.error.code, failure.error.detail),
Err(_) => format!("HTTP {status}"),
};
Err(message.into())
}
fn main() -> Result<(), Box<dyn Error>> {
let latest: Latest = get("/rates/latest?base=EUR")?;
let usd = latest.rates.get("USD").ok_or("USD fehlt")?;
println!("EUR zu USD am {}: {usd}", latest.date);
Ok(())
}
package main
import (
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.rateflowapi.com/v1/rates/latest?base=EUR", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("RATEFLOW_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var body struct {
Data struct {
Date string `json:"date"`
Rates map[string]float64 `json:"rates"`
} `json:"data"`
Error struct {
Code string `json:"code"`
Detail string `json:"detail"`
} `json:"error"`
}
if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
panic(err)
}
if resp.StatusCode != http.StatusOK {
fmt.Fprintf(os.Stderr, "%d %s: %s\n", resp.StatusCode, body.Error.Code, body.Error.Detail)
os.Exit(1)
}
fmt.Printf("EUR zu USD am %s: %v\n", body.Data.Date, body.Data.Rates["USD"])
}
using System.Text.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("RATEFLOW_API_KEY"));
var response = await client.GetAsync("https://api.rateflowapi.com/v1/rates/latest?base=EUR");
var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
if (!response.IsSuccessStatusCode)
{
var error = body.GetProperty("error");
Console.Error.WriteLine($"{(int)response.StatusCode} {error.GetProperty("code")}: {error.GetProperty("detail")}");
Environment.ExitCode = 1;
return;
}
var data = body.GetProperty("data");
Console.WriteLine($"EUR zu USD am {data.GetProperty("date")}: {data.GetProperty("rates").GetProperty("USD")}");
Betrag umrechnen
Das Beispiel rechnet 100 EUR mit dem Paar-Endpunkt in USD um. Ohne amount liefert die API nur den Kurs.
curl -sS --fail-with-body \
-H "X-API-Key: $RATEFLOW_API_KEY" \
"https://api.rateflowapi.com/v1/rates/pair/EUR/USD?amount=100"
<?php
$ch = curl_init('https://api.rateflowapi.com/v1/rates/pair/EUR/USD?amount=100');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('RATEFLOW_API_KEY')],
]);
$body = json_decode((string) curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status !== 200) {
fwrite(STDERR, "{$status} {$body['error']['code']}: {$body['error']['detail']}" . PHP_EOL);
exit(1);
}
echo "100 EUR = {$body['data']['converted']} USD (Kurs {$body['data']['rate']})" . PHP_EOL;
const response = await fetch('https://api.rateflowapi.com/v1/rates/pair/EUR/USD?amount=100', {
headers: { 'X-API-Key': process.env.RATEFLOW_API_KEY },
});
const body = await response.json();
if (!response.ok) {
throw new Error(`${response.status} ${body.error.code}: ${body.error.detail}`);
}
console.log(`100 EUR = ${body.data.converted} USD (Kurs ${body.data.rate})`);
import os
import requests
response = requests.get(
"https://api.rateflowapi.com/v1/rates/pair/EUR/USD",
params={"amount": 100},
headers={"X-API-Key": os.environ["RATEFLOW_API_KEY"]},
timeout=10,
)
body = response.json()
if not response.ok:
raise SystemExit(f"{response.status_code} {body['error']['code']}: {body['error']['detail']}")
print(f"100 EUR = {body['data']['converted']} USD (Kurs {body['data']['rate']})")
use serde::{de::DeserializeOwned, Deserialize};
use std::{env, error::Error};
#[derive(Deserialize)]
struct Success<T> {
data: T,
}
#[derive(Deserialize)]
struct Failure {
error: ApiError,
}
#[derive(Deserialize)]
struct ApiError {
code: String,
detail: String,
}
#[derive(Deserialize)]
struct Pair {
rate: f64,
converted: f64,
}
fn get<T: DeserializeOwned>(path: &str) -> Result<T, Box<dyn Error>> {
let response = reqwest::blocking::Client::new()
.get(format!("https://api.rateflowapi.com/v1{path}"))
.header("X-API-Key", env::var("RATEFLOW_API_KEY")?)
.send()?;
let status = response.status();
if status.is_success() {
return Ok(response.json::<Success<T>>()?.data);
}
let body = response.text()?;
let message = match serde_json::from_str::<Failure>(&body) {
Ok(failure) => format!("{} {}: {}", status.as_u16(), failure.error.code, failure.error.detail),
Err(_) => format!("HTTP {status}"),
};
Err(message.into())
}
fn main() -> Result<(), Box<dyn Error>> {
let pair: Pair = get("/rates/pair/EUR/USD?amount=100")?;
println!("100 EUR = {} USD (Kurs {})", pair.converted, pair.rate);
Ok(())
}
package main
import (
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.rateflowapi.com/v1/rates/pair/EUR/USD?amount=100", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("RATEFLOW_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var body struct {
Data struct {
Rate float64 `json:"rate"`
Converted float64 `json:"converted"`
} `json:"data"`
Error struct {
Code string `json:"code"`
Detail string `json:"detail"`
} `json:"error"`
}
if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
panic(err)
}
if resp.StatusCode != http.StatusOK {
fmt.Fprintf(os.Stderr, "%d %s: %s\n", resp.StatusCode, body.Error.Code, body.Error.Detail)
os.Exit(1)
}
fmt.Printf("100 EUR = %v USD (Kurs %v)\n", body.Data.Converted, body.Data.Rate)
}
using System.Text.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("RATEFLOW_API_KEY"));
var response = await client.GetAsync("https://api.rateflowapi.com/v1/rates/pair/EUR/USD?amount=100");
var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
if (!response.IsSuccessStatusCode)
{
var error = body.GetProperty("error");
Console.Error.WriteLine($"{(int)response.StatusCode} {error.GetProperty("code")}: {error.GetProperty("detail")}");
Environment.ExitCode = 1;
return;
}
var data = body.GetProperty("data");
Console.WriteLine($"100 EUR = {data.GetProperty("converted")} USD (Kurs {data.GetProperty("rate")})");
Historischer Kurs
Das Beispiel ruft den Kurs EUR zu USD für den 1. März 2026 ab. Historische Kurse erfordern einen Pro- oder Business-Tarif. Im Free-Tarif geben die Beispiele den Fehler 403 PLAN_UPGRADE_REQUIRED aus. Das Antwortfeld date ist der Tag, an dem der Kurs veröffentlicht wurde. Er kann vor dem angefragten Tag liegen, zum Beispiel an einem Wochenende (siehe Historische Kurse).
curl -sS --fail-with-body \
-H "X-API-Key: $RATEFLOW_API_KEY" \
"https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01"
<?php
$ch = curl_init('https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('RATEFLOW_API_KEY')],
]);
$body = json_decode((string) curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status !== 200) {
fwrite(STDERR, "{$status} {$body['error']['code']}: {$body['error']['detail']}" . PHP_EOL);
exit(1);
}
echo "EUR zu USD am {$body['data']['date']}: {$body['data']['rate']}" . PHP_EOL;
const response = await fetch('https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01', {
headers: { 'X-API-Key': process.env.RATEFLOW_API_KEY },
});
const body = await response.json();
if (!response.ok) {
throw new Error(`${response.status} ${body.error.code}: ${body.error.detail}`);
}
console.log(`EUR zu USD am ${body.data.date}: ${body.data.rate}`);
import os
import requests
response = requests.get(
"https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01",
headers={"X-API-Key": os.environ["RATEFLOW_API_KEY"]},
timeout=10,
)
body = response.json()
if not response.ok:
raise SystemExit(f"{response.status_code} {body['error']['code']}: {body['error']['detail']}")
print(f"EUR zu USD am {body['data']['date']}: {body['data']['rate']}")
use serde::{de::DeserializeOwned, Deserialize};
use std::{env, error::Error};
#[derive(Deserialize)]
struct Success<T> {
data: T,
}
#[derive(Deserialize)]
struct Failure {
error: ApiError,
}
#[derive(Deserialize)]
struct ApiError {
code: String,
detail: String,
}
#[derive(Deserialize)]
struct Historical {
date: String,
rate: f64,
}
fn get<T: DeserializeOwned>(path: &str) -> Result<T, Box<dyn Error>> {
let response = reqwest::blocking::Client::new()
.get(format!("https://api.rateflowapi.com/v1{path}"))
.header("X-API-Key", env::var("RATEFLOW_API_KEY")?)
.send()?;
let status = response.status();
if status.is_success() {
return Ok(response.json::<Success<T>>()?.data);
}
let body = response.text()?;
let message = match serde_json::from_str::<Failure>(&body) {
Ok(failure) => format!("{} {}: {}", status.as_u16(), failure.error.code, failure.error.detail),
Err(_) => format!("HTTP {status}"),
};
Err(message.into())
}
fn main() -> Result<(), Box<dyn Error>> {
let historical: Historical = get("/rates/history/EUR/USD/2026-03-01")?;
println!("EUR zu USD am {}: {}", historical.date, historical.rate);
Ok(())
}
package main
import (
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("RATEFLOW_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var body struct {
Data struct {
Date string `json:"date"`
Rate float64 `json:"rate"`
} `json:"data"`
Error struct {
Code string `json:"code"`
Detail string `json:"detail"`
} `json:"error"`
}
if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
panic(err)
}
if resp.StatusCode != http.StatusOK {
fmt.Fprintf(os.Stderr, "%d %s: %s\n", resp.StatusCode, body.Error.Code, body.Error.Detail)
os.Exit(1)
}
fmt.Printf("EUR zu USD am %s: %v\n", body.Data.Date, body.Data.Rate)
}
using System.Text.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("RATEFLOW_API_KEY"));
var response = await client.GetAsync("https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01");
var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
if (!response.IsSuccessStatusCode)
{
var error = body.GetProperty("error");
Console.Error.WriteLine($"{(int)response.StatusCode} {error.GetProperty("code")}: {error.GetProperty("detail")}");
Environment.ExitCode = 1;
return;
}
var data = body.GetProperty("data");
Console.WriteLine($"EUR zu USD am {data.GetProperty("date")}: {data.GetProperty("rate")}");