Verfügbare Endpunkte

Basis-URL und gemeinsame Parameter

Alle Endpunkte sind GET-Anfragen unter https://metalapi.com/api/v1 und erfordern einen API-Schlüssel (siehe Authentifizierung). Die meisten akzeptieren dieselben optionalen Parameter:

• base: die Währung, in der die Preise angegeben werden. Standard ist USD; jedes unterstützte Symbol ist möglich.
• currencies oder der Alias symbols: eine kommagetrennte Liste der zurückzugebenden Symbole, etwa XAU,XAG,EUR. Ohne diesen Parameter erhalten Sie alle Symbole.
• unit: die Masseneinheit für Metallpreise. Einer der Werte troy_oz (Standard), gram, kilogram, ounce, pound, metric_ton oder short_ton.

Datumsangaben haben das Format YYYY-MM-DD und werden als UTC interpretiert.

Aktuelle Kurse: /latest

Aktuelle Preise im Aktualisierungsintervall Ihres Tarifs, von täglich im Free-Tarif bis alle 5 Sekunden im Enterprise-Tarif. Ab dem Standard-Tarif fügen Sie Symbole wie XAU-BID und XAU-ASK zu currencies hinzu, um Geld- und Briefkurse zu erhalten.

GET https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,EUR

Historische Kurse: /{date}

Schlusskurse eines vergangenen Tages. Drei Schreibweisen werden akzeptiert: das Datum als Pfad, /historical?date= oder /yesterday.

GET /api/v1/2026-10-01?api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/historical?date=2026-10-01&api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/yesterday?api_key=YOUR_API_KEY&currencies=XAU,XAG

Umrechnen: /convert

Rechnet amount von from in to um, zum Beispiel Dollar in Unzen Gold oder Silber in Euro. Mit date rechnen Sie zu einem historischen Schlusskurs um, mit unit geben Sie Metallmengen in Gramm oder Kilogramm an.

GET /api/v1/convert?api_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

# 500 Gramm Silber in Euro zum Schlusskurs vom 1. Oktober 2026
GET /api/v1/convert?api_key=YOUR_API_KEY&from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01

Zeitraum: /timeframe

Tägliche Schlusskurse für jeden Tag zwischen start_date und end_date. Eine Anfrage kann im Free-Tarif bis zu 30 Tage und in kostenpflichtigen Tarifen bis zu 365 Tage umfassen. Längere Zeiträume liefern Fehler 207. /timeseries ist ein aus Kompatibilitätsgründen beibehaltener Alias.

GET /api/v1/timeframe?api_key=YOUR_API_KEY&start_date=2026-09-01&end_date=2026-09-30&currencies=XAU

Veränderung: /change

Anfangskurs, Endkurs sowie absolute und prozentuale Veränderung zwischen zwei Daten für jedes Symbol. Praktisch für Anzeigen wie „Gold ist diesen Monat um 3,6 % gestiegen“. Es gelten dieselben Zeitraumlimits wie bei /timeframe.

GET /api/v1/change?api_key=YOUR_API_KEY&start_date=2026-09-30&end_date=2026-10-23&currencies=XAU,XAG

OHLC: /ohlc

Eröffnungs-, Höchst-, Tiefst- und Schlusskurs eines einzelnen Tages. Lassen Sie date weg oder übergeben Sie latest, um die bisherigen Werte des heutigen Tages zu erhalten.

GET /api/v1/ohlc?api_key=YOUR_API_KEY&date=2026-10-22&currencies=XAU,XAG

Gold nach Karat: /carat

Goldpreise in den Schmuckfeinheiten von 24 bis 8 Karat, in jeder Währung und Einheit. Übergeben Sie carat=24 (Standard), einen einzelnen Karatwert wie 18 oder carat=all. Unterstützt werden 24, 23, 22, 21, 20, 18, 16, 14, 12, 10, 9 und 8 Karat. Mit date erhalten Sie historische Karatpreise.

Dieser Endpunkt ist in den kostenpflichtigen Tarifen verfügbar. Free-Schlüssel erhalten Fehler 106.

GET /api/v1/carat?api_key=YOUR_API_KEY&carat=all&base=EUR&unit=gram

Symbole: /symbols

Die Liste der unterstützten Symbole mit ihren Namen. Mit details=1 erhalten Sie zusätzlich Kategorie und Einheit jedes Symbols. Dieser Endpunkt wird nicht auf Ihr Monatskontingent angerechnet.

GET /api/v1/symbols?api_key=YOUR_API_KEY&details=1

Nutzung: /usage

Verbrauchte und verbleibende Anfragen im aktuellen Abrechnungsmonat. Auch dieser Endpunkt ist kostenlos, Sie können ihn also aus Ihrem Monitoring aufrufen, ohne Kontingent zu verbrauchen.

GET /api/v1/usage?api_key=YOUR_API_KEY

Echtzeit-Stream: /stream

Ein Server-Sent-Events-Stream, der Preisänderungen sofort überträgt, sodass Sie /latest nicht regelmäßig abfragen müssen. Verfügbar ab dem Pro-Tarif. Die Streaming-Dokumentation beschreibt das Event-Format.

curl -N "https://metalapi.com/api/v1/stream" \
  -H "Authorization: Bearer YOUR_API_KEY"