Kupfer-, Aluminium-, Zink- und Ölpreise per API: Ein Leitfaden für Entwickler

Die Symbole für Industriemetalle und Energie

Edelmetalle bekommen die meisten Schlagzeilen, doch viele Unternehmen interessieren sich stärker für Kupfer, Aluminium, Stahl und Kraftstoff. Sie bestimmen die Kosten von Kabeln und Motoren, Dosen und Karosserien, Baustahl und jedem Lkw, der Waren transportiert. MetalAPI notiert neben Gold und Silber vier Industriemetalle und fünf Energiekontrakte, über dieselben Endpunkte und im selben Antwortformat.

Die Seite Symbole listet sie mit Live-Preisen auf, und GET /api/v1/symbols?details=1 liefert Kategorie und Einheit jedes Symbols als JSON. Dieser Aufruf ist kostenlos und wird nicht auf Ihr Kontingent angerechnet.

Marktübliche Einheiten und die Normalisierung der API

Jeder dieser Märkte hat seine eigene Konvention. In New York wird Kupfer pro Pfund gehandelt, Aluminium und Zink pro metrischer Tonne, US-Stahl pro Short Ton, Rohöl pro Barrel, Erdgas pro Million British Thermal Units (MMBtu) und Raffinerieprodukte pro Gallone. Wer sie verwechselt, liegt mit seinen Zahlen um den Faktor tausend oder mehr daneben.

MetalAPI normalisiert die Metalle und belässt Energie in ihren Kontrakteinheiten:

• Alle Metalle, Edel- wie Industriemetalle, werden standardmäßig pro Feinunze notiert. So bleiben alle Metalle direkt vergleichbar, und jedes lässt sich mit einem einzigen Parameter umrechnen. Kupfer pro Feinunze handelt allerdings niemand, daher übergeben Sie bei Industriemetallen fast immer unit.
• Energie wird pro Kontrakteinheit notiert: Barrel für WTI und BRENT, MMBtu für NATURALGAS, US-Gallonen für GASOLINE und HEATINGOIL. Der Parameter unit gilt nicht für Energie, Währungen oder Krypto.

unit akzeptiert troy_oz (Standard), gram, kilogram, ounce, pound, metric_ton und short_ton. So erhalten Sie jedes Metall in der Einheit seines Marktes:

# Kupfer in USD pro Pfund
curl "https://metalapi.com/api/v1/latest?currencies=XCU&unit=pound" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Aluminium und Zink in USD pro metrischer Tonne
curl "https://metalapi.com/api/v1/latest?currencies=ALU,ZNC&unit=metric_ton" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Warmbandstahl in USD pro Short Ton
curl "https://metalapi.com/api/v1/latest?currencies=HRC&unit=short_ton" \
  -H "Authorization: Bearer YOUR_API_KEY"

Wird eine andere als die Standardeinheit verwendet, weist die Antwort sie im Feld unit aus. Der gesuchte Preis steht unter dem Schlüssel mit vorangestellter Basiswährung (USDXCU); der einfache Schlüssel XCU ist sein Kehrwert, der aus Kompatibilitätsgründen für ältere Integrationen erhalten bleibt:

{
  "success": true,
  "timestamp": 1792834892,
  "date": "2026-10-24",
  "base": "USD",
  "unit": "pound",
  "rates": {
    "XCU": 0.2222222222,
    "USDXCU": 4.5
  }
}

Futures-basierte Preise und was Frontmonat bedeutet

Spot-Gold wird außerbörslich rund um die Uhr gehandelt, Industriemetalle und Energie werden dagegen am transparentesten an Terminbörsen bepreist. MetalAPI bezieht diese Preise von COMEX und NYMEX (beide Teil der CME Group) sowie von ICE. Ein Futures-Kontrakt ist eine standardisierte Vereinbarung, eine festgelegte Menge zu einem festgelegten Preis mit Lieferung in einem bestimmten Monat zu kaufen oder zu verkaufen. Jeder Liefermonat ist ein eigener Kontrakt mit eigenem Preis.

Der Frontmonat ist der nächstgelegene Liefermonat, der noch gehandelt wird. Eine fortlaufende Frontmonatsreihe folgt diesem Kontrakt, bis er sich dem Verfall nähert, und wechselt dann zum nächsten; dieser Wechsel heißt Rollen. Für Entwickler hat das drei Folgen:

• Roll-Sprünge. An einem Rolltermin kann die Reihe springen, nicht weil sich der Markt bewegt hat, sondern weil der nächste Kontrakt zu einem anderen Preis gehandelt wird. Sind spätere Monate teurer (Contango), springt die Reihe nach oben; sind sie günstiger (Backwardation), springt sie nach unten. Denken Sie daran, bevor Sie rund um einen Verfallstermin wegen einer Tagesveränderung Alarm auslösen.
• Eine Börse ist nicht der ganze Markt. Ein COMEX-Kupferpreis ist der Preis einer US-Börse. Ein Großteil des weltweit physisch gehandelten Kupfers, Aluminiums und Zinks wird auf Basis der London Metal Exchange bepreist, und physische Lieferungen enthalten zusätzlich regionale Aufschläge, Fracht und Steuern. Die Preise verschiedener Handelsplätze laufen eng zusammen, aber nicht exakt gleich. Nennt ein Liefervertrag eine bestimmte Referenz, etwa einen offiziellen LME-Preis oder eine veröffentlichte Preisnotierung, ist diese Referenz für Ihre Rechnung maßgeblich. Ein Futures-Feed einer Börse ist ein gutes Werkzeug zur Beobachtung und Schätzung, aber kein Ersatz für den vertraglich vereinbarten Index.
• Handelszeiten. Diese Kontrakte folgen den Handelszeiten ihrer Börsen: nahezu rund um die Uhr von Sonntagabend bis Freitagnachmittag New Yorker Zeit, mit einer kurzen täglichen Pause. Am Wochenende liefert MetalAPI weiterhin den letzten Preis.

Da diese Symbole aus Futures stammen, werden sie mit einem einzigen Preis veröffentlicht; Suffixe für Geld- und Briefkurse sind für sie nicht verfügbar. Die Tageshistorie für Metalle und Energie reicht bis ins Jahr 2000 zurück, und die Anleitung zu historischen Daten zeigt, wie Sie Schlusskurse, Zeiträume und OHLC-Balken abfragen.

Einheiten und Währungen umrechnen

Wenn Sie mehrere Metalle in unterschiedlichen Einheiten brauchen, ist eine Anfrage in Feinunzen mit Umrechnung in Ihrem eigenen Code am günstigsten. Eine Datenanfrage zählt einmal, egal wie viele Symbole sie liefert; das kostet also eine Anfrage statt drei. Die folgenden Konstanten ergeben sich aus den Definitionen der Einheiten:

// Feinunzen pro Masseneinheit
const GRAMS_PER_TROY_OZ = 31.1034768;
const TROY_OZ_PER = {
  lb: 453.59237 / GRAMS_PER_TROY_OZ,        // 14.5833…
  short_ton: 907184.74 / GRAMS_PER_TROY_OZ, // 29,166.67…
  metric_ton: 1e6 / GRAMS_PER_TROY_OZ,      // 32,150.75…
};

const NATURAL_UNIT = { XCU: "lb", ALU: "metric_ton", ZNC: "metric_ton", HRC: "short_ton" };

const url = new URL("https://metalapi.com/api/v1/latest");
url.searchParams.set("currencies", Object.keys(NATURAL_UNIT).join(","));

const res = await fetch(url, { headers: { "X-API-Key": process.env.METALAPI_KEY } });
const data = await res.json();
if (!data.success) throw new Error(data.error.code + ": " + data.error.info);

for (const [symbol, unit] of Object.entries(NATURAL_UNIT)) {
  const perTroyOz = data.rates["USD" + symbol]; // USD pro Feinunze
  if (perTroyOz === undefined) continue;
  console.log(symbol, (perTroyOz * TROY_OZ_PER[unit]).toFixed(2), "USD per", unit);
}

Währungen funktionieren bei Metallen und Energie gleich. Fügen Sie base=EUR oder eine andere der 57 unterstützten Währungen hinzu, und jeder Preis in der Antwort wird in dieser Währung angegeben, umgerechnet aus demselben Snapshot. Um eine Menge direkt zu bewerten, nimmt /convert einen Betrag und eine Einheit entgegen:

# 25 metrische Tonnen Kupfer in Euro
curl "https://metalapi.com/api/v1/convert?from=XCU&to=EUR&amount=25&unit=metric_ton" \
  -H "Authorization: Bearer YOUR_API_KEY"

Energieumrechnungen erfolgen in Ihrem Code. Nützliche Standardfaktoren: Ein Barrel sind 42 US-Gallonen oder etwa 158,987 Liter, eine US-Gallone sind 3,785411784 Liter, und eine MMBtu entspricht etwa 1,055 Gigajoule, 293,07 kWh oder 10 Therms. Die Umrechnung von Barrel Rohöl in Tonnen hängt von der Dichte des Öls ab; verwenden Sie daher den Faktor für die Sorte, die Sie tatsächlich kaufen.

Anwendungsfall: Einkauf und Kostenüberwachung

Einkaufsteams nutzen Börsenpreise, um zu verstehen, wohin sich die Kosten ihrer Vorprodukte bewegen, und um Lieferantenangebote auf Plausibilität zu prüfen. Typische Bausteine:

• Ein tägliches Dashboard mit Kupfer, Aluminium, Stahl und Diesel in den Einheiten und der Währung Ihrer Verträge.
• Veränderung gegenüber dem Vorzeitraum mit /change, das für jedes Symbol in einer einzigen Anfrage Anfangspreis, Endpreis sowie absolute und prozentuale Veränderung zwischen zwei Daten liefert.
• Schwellenwert-Alarme. In kostenpflichtigen Tarifen senden Preisalarme im Dashboard eine E-Mail, ab dem Advanced-Tarif auch einen signierten Webhook, wenn ein Preis eine Marke überschreitet oder sich um einen bestimmten Prozentsatz bewegt. So lässt sich auf einfache Weise die Überprüfung einer Budgetannahme anstoßen.
• Angebotsprüfung. Ein Vergleich des Metallanteils im Preis eines Lieferanten mit der Börsenreferenz zeigt, wie viel einer Preisänderung auf das Metall und wie viel auf Aufschläge oder Verarbeitung entfällt.

# Kupfer und Aluminium pro metrischer Tonne: Veränderung im September 2026
curl "https://metalapi.com/api/v1/change?currencies=XCU,ALU&unit=metric_ton&start_date=2026-09-01&end_date=2026-09-30" \
  -H "Authorization: Bearer YOUR_API_KEY"

Behalten Sie den Hinweis von oben im Kopf: Ist ein Vertrag an einen bestimmten veröffentlichten Preis gekoppelt, gleichen Sie alles, was auf einer Rechnung landet, mit diesem Index ab.

Anwendungsfall: Kostenmodelle in der Fertigung

Eine Stückliste führt den Metallanteil meist in Kilogramm auf. Da unit für jedes Metall kilogram akzeptiert, liefert eine einzige Anfrage den Kilopreis aller Metalle in Ihrer Berichtswährung:

import os
import requests

# Metallanteil pro Produkteinheit in kg (Beispielwerte)
BOM = {"XCU": 1.20, "ALU": 0.85, "ZNC": 0.05}

resp = requests.get(
    "https://metalapi.com/api/v1/latest",
    params={"currencies": ",".join(BOM), "unit": "kilogram", "base": "EUR"},
    headers={"X-API-Key": os.environ["METALAPI_KEY"]},
    timeout=10,
)
data = resp.json()
if not data.get("success"):
    raise RuntimeError(data["error"])

total = 0.0
for symbol, kg in BOM.items():
    eur_per_kg = data["rates"]["EUR" + symbol]
    cost = kg * eur_per_kg
    total += cost
    print(f"{symbol}: {kg} kg x {eur_per_kg:.4f} EUR/kg = {cost:.2f} EUR")

print(f"Metal content per unit: {total:.2f} EUR (prices of {data['date']})")

Zwei Verfeinerungen machen ein solches Modell nützlicher. Erstens: Speichern Sie Preis, Einheit und Zeitstempel, die Sie verwendet haben, zusammen mit jeder Kostenberechnung, damit Sie später erklären können, warum sich Kosten verändert haben. Zweitens: Erwägen Sie einen Durchschnitt über einen Zeitraum statt eines einzelnen aktuellen Preises; das glättet tägliches Rauschen und Roll-Sprünge. /timeframe liefert in kostenpflichtigen Tarifen Tagesschlusskurse für bis zu 365 Tage pro Anfrage (30 Tage im Free-Tarif), genug für einen Monats- oder Quartalsdurchschnitt mit einem einzigen Aufruf.

Anwendungsfall: Logistik und Kraftstoffkosten

Kraftstoff ist für viele Transportunternehmen der größte variable Kostenblock, und Treibstoffzuschläge werden oft wöchentlich oder monatlich neu berechnet. HEATINGOIL, der Kontrakt für schwefelarmen Diesel (ULSD) im New Yorker Hafen, ist eine viel beachtete Großhandelsreferenz für Diesel. GASOLINE (RBOB) erfüllt dieselbe Rolle für Benzin, und WTI und BRENT decken Rohöl ab.

Großhandels-Futures und Tankstellenpreise sind zwei verschiedene Dinge: Endkundenpreise enthalten zusätzlich Vertriebskosten, Margen und Steuern und folgen den Futures mit Verzögerung. Viele Zuschlagstabellen beziehen sich auf einen veröffentlichten Durchschnitt der Endkundenpreise. Ist das bei Ihnen der Fall, ist dieser Durchschnitt die maßgebliche Zahl. Futures-Daten sind trotzdem nützlich, um Kosten intern zu verfolgen und Bewegungen auf den vorgelagerten Märkten früh zu erkennen.

Dieses Beispiel mittelt die Tagesschlusskurse des Dieselkontrakts der vergangenen Woche und rechnet das Ergebnis von USD pro Gallone in EUR pro Liter um:

const LITRES_PER_GALLON = 3.785411784;

const url = new URL("https://metalapi.com/api/v1/timeframe");
url.searchParams.set("currencies", "HEATINGOIL");
url.searchParams.set("base", "EUR");
url.searchParams.set("start_date", "2026-10-19");
url.searchParams.set("end_date", "2026-10-23");

const res = await fetch(url, { headers: { "X-API-Key": process.env.METALAPI_KEY } });
const data = await res.json();
if (!data.success) throw new Error(data.error.code + ": " + data.error.info);

// rates ist nach Datum geschlüsselt; Tage ohne Schlusskurs (Wochenenden, Feiertage) fehlen
const closes = Object.values(data.rates).map((day) => day.EURHEATINGOIL);
const avgPerGallon = closes.reduce((sum, p) => sum + p, 0) / closes.length;

console.log("Average:", (avgPerGallon / LITRES_PER_GALLON).toFixed(4), "EUR per litre");

Praktische Tipps

• Im Intervall Ihres Tarifs abfragen, nicht häufiger. Free erhält tägliche Preise, Lite alle 30 Minuten, Standard alle 10 Minuten, Advanced und Pro jede Minute, Ultra und Business alle 15 Sekunden und Enterprise alle 5 Sekunden. Anfragen dazwischen liefern denselben Snapshot und zählen trotzdem. Ab dem Pro-Tarif ersetzt der Echtzeit-Stream das Polling.
• Symbole bündeln. Eine Anfrage kann alle neun Industrie- und Energiesymbole zurückgeben und kostet genauso viel wie eine Anfrage für ein einzelnes Symbol.
• Speichern, was Sie abgerufen haben. Speichern Sie jeden Preis mit Symbol, Einheit, Basiswährung und timestamp. Später umzurechnen ist einfach; die Einheit einer alten Zahl zu erraten nicht.
• Mit Lücken in der Historie rechnen. Tägliche Reihen überspringen Wochenenden und Börsenfeiertage. Gehen Sie also nicht von einem Eintrag pro Kalendertag aus.
• Lange Zeiträume aufteilen. Eine einzelne /timeframe-Anfrage umfasst in kostenpflichtigen Tarifen bis zu 365 Tage. Für längere Historien bis zurück ins Jahr 2000 gehen Sie daher Jahr für Jahr vor.
• Vor dem Senden prüfen. Anfragen, die wegen ungültiger Daten, Symbole oder Einheiten abgelehnt werden, zählen trotzdem auf Ihr Kontingent. Prüfen Sie sie daher zuerst in Ihrem Code. Ablehnungen wegen Anfragelimits und Serverfehler werden nicht berechnet.

Für den Einstieg registrieren Sie sich für einen kostenlosen Schlüssel, sehen sich auf der Seite Symbole die Live-Preise für Industriemetalle und Energie an und finden in der API-Dokumentation alle Endpunkte und Parameter. Die Seite Preise listet Aktualisierungsintervall und Kontingent jedes Tarifs auf.