Datenformate & Einheiten

Zwei Richtungen für jeden Kurs

Für jedes angefragte Symbol enthält rates zwei Zahlen. Für Gold (XAU) mit der Basis USD:

• USDXAU: der Preis einer Feinunze Gold in US-Dollar, etwa 3997.89. Diesen Wert zeigen Sie Ihren Nutzern an.
• XAU: der Kehrwert, also Feinunzen Gold pro US-Dollar, etwa 0.0002501319446. Dieses Format bleibt aus Gründen der Kompatibilität mit Forex-APIs erhalten.

Für Währungen gilt dieselbe Regel. Mit der Basis USD ist USDEUR der Preis eines Euro in Dollar und EUR die Anzahl Euro pro Dollar.

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "EUR": 0.8589589418,
    "USDEUR": 1.1642
  }
}

Basiswährung wählen

base legt die Währung aller Preise in der Antwort fest. Standard ist USD; akzeptiert wird jedes unterstützte Symbol: EUR, GBP, JPY oder sogar BTC oder XAU, wenn Sie Werte in Bitcoin oder Gold ausdrücken möchten. Kreuzkurse werden aus demselben Snapshot berechnet und sind daher immer untereinander konsistent.

Diese Anfrage liefert EURXAU, den Goldpreis in Euro pro Feinunze:

GET /api/v1/latest?api_key=YOUR_API_KEY&base=EUR&currencies=XAU,XAG

Masseneinheiten

Metallpreise gelten pro Feinunze (31,1035 g), sofern Sie nicht unit angeben. Unterstützte Werte:

• troy_oz (Standard), gram, kilogram, ounce (Avoirdupois, 28,35 g), pound, metric_ton und short_ton

Kurzformen wie g, kg, lb und tonne werden ebenfalls akzeptiert. Beachten Sie, dass oz die Avoirdupois-Unze bezeichnet. Für die Feinunze, in der Edelmetallbarren gehandelt werden, verwenden Sie troy_oz oder lassen unit weg.

unit gilt nur für Edel- und Industriemetalle. Energie bleibt pro Barrel, MMBtu oder Gallone, Währungen und Krypto sind nicht betroffen. Bei einer anderen als der Standardeinheit enthält die Antwort ein unit-Feld. Für GET /api/v1/latest?base=EUR&currencies=XAU,XAG&unit=gram:

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "EUR",
  "unit": "gram",
  "rates": {
    "XAU": 0.009057444725,
    "EURXAU": 110.4064149,
    "XAG": 0.6713138244,
    "EURXAG": 1.489616277
  }
}

Industriemetalle und Energie

Industriemetalle (XCU Kupfer, ALU Aluminium, ZNC Zink und HRC Warmbandstahl) werden standardmäßig wie alle anderen Metalle pro Feinunze notiert, sodass sich alle Metalle direkt vergleichen lassen. Für die jeweils marktübliche Einheit übergeben Sie unit=pound für Kupfer, unit=metric_ton für Aluminium und Zink und unit=short_ton für Stahl.

Energiepreise gelten pro Kontrakteinheit: WTI und BRENT pro Barrel, NATURALGAS pro MMBtu sowie GASOLINE und HEATINGOIL pro Gallone.

GET /api/v1/latest?api_key=YOUR_API_KEY&currencies=XCU&unit=pound

Unterstützte Symbole

• Edelmetalle: XAU Gold, XAG Silber, XPT Platin, XPD Palladium
• Industriemetalle: XCU Kupfer, ALU Aluminium, ZNC Zink, HRC Stahl
• Energie: WTI, BRENT, NATURALGAS, GASOLINE, HEATINGOIL
• Währungen: rund 55 Währungen nach ISO 4217, darunter USD, EUR, GBP, JPY, CHF, CAD, AUD, CNY und INR
• Krypto: BTC, ETH, SOL, XRP, BNB, ADA, DOGE, DOT, LINK, LTC, TRX, USDT, USDC

Die vollständige, aktuelle Liste finden Sie auf der Symbolseite und über /api/v1/symbols.

Geld- und Briefkurse

Ab dem Standard-Tarif hängen Sie in currencies -BID oder -ASK an ein Symbol an, um zusätzlich zum Mittelkurs Geld- und Briefkurse zu erhalten. Sie sind für Symbole verfügbar, die aus Interbanken-Feeds stammen, also für die Edelmetalle und die wichtigsten Währungen. Für currencies=XAU,XAU-BID,XAU-ASK:

"rates": {
  "XAU": 0.0002501319446,
  "USDXAU": 3997.89,
  "XAU-BID": 0.0002501488386,
  "USDXAU-BID": 3997.62,
  "XAU-ASK": 0.0002501150529,
  "USDXAU-ASK": 3998.16
}

Goldpreise nach Karat

/carat liefert Goldpreise in Schmuckfeinheiten (Feinheit = Karat ÷ 24) in jeder Währung und Einheit. Der Endpunkt ist in den kostenpflichtigen Tarifen verfügbar. Für GET /api/v1/carat?carat=all&unit=gram (gekürzt):

{
  "success": true,
  "carat": "all",
  "date": "2026-10-23",
  "base": "USD",
  "timestamp": 1792765800,
  "rates": {
    "XAU24K": { "price": 128.53515, "unit": "gram", "carat": "24", "purity": 1 },
    "XAU22K": { "price": 117.82389, "unit": "gram", "carat": "22", "purity": 0.916667 },
    "XAU18K": { "price": 96.401361, "unit": "gram", "carat": "18", "purity": 0.75 },
    "XAU14K": { "price": 74.978836, "unit": "gram", "carat": "14", "purity": 0.583333 }
  }
}

Zeitstempel und Datumsangaben

timestamp ist die Unix-Zeit in Sekunden (UTC) der gelieferten Preise. date ist derselbe Tag im Format YYYY-MM-DD in UTC. Historische Antworten tragen den Zeitstempel 00:00 UTC des angefragten Tages und enthalten die Schlusskurse dieses Tages.

const date = new Date(data.timestamp * 1000);
console.log(date.toISOString()); // 2026-10-23T14:30:00.000Z

Genauigkeit

Kurse sind JSON-Zahlen mit bis zu 10 signifikanten Stellen, was auch für Kehrwerte wie 0.0002501319446 ausreicht. Runden Sie erst bei der Anzeige eines Werts, nicht bevor Sie damit rechnen.

Handelszeiten und Wochenenden

Spot-Metalle und Währungen werden an Werktagen rund um die Uhr gehandelt. Die Märkte schließen freitags um 17:00 Uhr New Yorker Zeit und öffnen sonntags um 17:00 Uhr wieder. Am Wochenende bleiben die Preise auf dem letzten Kurs stehen, und die API liefert weiterhin den Schlusskurs vom Freitag (die Symbolseiten zeigen dann „Markt geschlossen“).

Krypto wird rund um die Uhr an sieben Tagen die Woche gehandelt und auch am Wochenende aktualisiert. Industriemetalle und Energie folgen den Handelszeiten ihrer Terminbörsen.