Erste Schritte mit MetalAPI

Einführung

MetalAPI ist eine JSON-REST-API für Spotpreise von Edelmetallen, Industriemetallen und Energie sowie für rund 55 Währungen und 13 Kryptowährungen. Sie liefert Echtzeitkurse, eine tägliche Historie bis zurück ins Jahr 1999, Umrechnungen, OHLC-Daten und Goldpreise nach Karat.

Jeder Endpunkt ist eine einfache HTTPS-GET-Anfrage unter https://metalapi.com/api/v1 und funktioniert daher mit jeder Programmiersprache und jedem HTTP-Client. Diese Anleitung führt Sie in wenigen Minuten von der Registrierung bis zur ersten Antwort.

API-Schlüssel erhalten

Erstellen Sie ein kostenloses Konto mit Ihrer E-Mail-Adresse. Eine Kreditkarte ist nicht erforderlich. Der Free-Tarif umfasst 100 Anfragen pro Monat mit täglicher Preisaktualisierung – genug, um die API auszuprobieren.

Öffnen Sie im Dashboard API keys und erstellen Sie einen Schlüssel. Schlüssel beginnen mit mk_live_, gefolgt von 32 Zeichen. Wir speichern nur einen Hash jedes Schlüssels, daher wird der vollständige Schlüssel nur ein einziges Mal angezeigt. Kopieren Sie ihn sofort in Ihren Passwortmanager oder in Ihre Umgebungsvariablen.

Die erste Anfrage

Rufen Sie die aktuellen Preise der vier Edelmetalle in US-Dollar ab. Ersetzen Sie YOUR_API_KEY durch Ihren Schlüssel:

curl "https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,XPT,XPD"

Die Antwort verstehen

base ist die Währung, in der die Preise angegeben werden (Standard: USD). currencies beschränkt die Antwort auf die Symbole, die Sie benötigen. Ohne diesen Parameter erhalten Sie alle Symbole in einer Antwort. Ein erfolgreicher Aufruf liefert JSON wie dieses:

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "XAG": 0.01853911754,
    "USDXAG": 53.94,
    "XPT": 0.000620212733,
    "USDXPT": 1612.35,
    "XPD": 0.0006775985906,
    "USDXPD": 1475.8
  },
  "rate_limit": {
    "limit": 100,
    "remaining": 99,
    "reset": 1793491200,
    "used": 1,
    "plan": "Free",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Jedes Symbol erscheint zweimal. USDXAU ist der Preis einer Feinunze Gold in der Basiswährung – in der Regel der Wert, den Sie anzeigen möchten. XAU ist der Kehrwert: wie viele Feinunzen man für einen US-Dollar erhält. Die Anleitung zu Datenformaten erklärt beide Richtungen ausführlich.

Der rate_limit-Block, der zusätzlich als X-RateLimit-*-Header gesendet wird, zeigt, wie viel von Ihrem Monatskontingent noch übrig ist und wann es zurückgesetzt wird.

Aufruf aus Ihrem Code

Hier dieselbe Anfrage in JavaScript (Node.js 18+, Deno oder Bun). Diesmal wird der Schlüssel in einem Header statt in der URL gesendet:

const res = await fetch("https://metalapi.com/api/v1/latest?currencies=XAU,XAG", {
  headers: { Authorization: `Bearer ${process.env.METALAPI_KEY}` },
});
const data = await res.json();

if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);
console.log("Gold, USD per troy ounce:", data.rates.USDXAU);

Nächste Schritte

• Authentifizierung: Schlüssel im Header und domainbeschränkte Schlüssel für den Einsatz im Browser.
• Verfügbare Endpunkte: historische Kurse, Umrechnung, Zeitreihen, OHLC und Karatpreise.
• Anfragelimits & Tarife: Kontingente, Limits pro Minute und Aktualisierungsintervalle.
• Fehlerbehandlung: Fehlercodes und eine sinnvolle Strategie für Wiederholungsversuche.