Matflixx API-Dokumentation: Rohstoffdaten integrieren

ÜbersichtOverview

Die matflixx-API liefert Marktdaten für Industriemetalle, Energie, Agrarrohstoffe, Edelmetalle und Devisen. Alle Anfragen erfolgen per HTTPS gegen app.matflixx.de, Authentifizierung per API-Key im x-api-key-Header. Die API ist read-only, es gibt keine schreibenden Endpoints. The matflixx API provides market data for base metals, energy, agricultural commodities, precious metals and currencies. All requests are HTTPS against app.matflixx.de, authentication via API key in the x-api-key header. The API is read-only; there are no write endpoints.

Echtzeit-NotierungenReal-time quotes

Aktuelle Kurse für jeden abonnierten Rohstoff inkl. Vortag, %-Änderung und Liefermonat.Current prices for every subscribed commodity with previous close, %-change and contract month.

Timeseries

Historische Kurse, beliebig aggregierbar (täglich, wöchentlich, monatlich) und zeitlich filterbar.Historical prices, freely aggregatable (daily, weekly, monthly) and time-filterable.

Futures & Forecasts

Forward-Kurven mit Liefermonat-Details und mittelfristige Preisprognosen unserer Analysten.Forward curves with delivery-month detail and medium-term price forecasts from our analysts.

News

Marktnachrichten und MIS-Konjunkturberichte (Filter nach Kategorie und Tag).Market news and MIS economic reports (filter by category and tag).

AuthentifizierungAuthentication

Jeder Request muss den Header x-api-key: <Ihr API-Schlüssel> mitsenden. Den Schlüssel erhalten Sie nach Vertragsabschluss vom matflixx-Vertrieb. Behandeln Sie ihn wie ein Passwort, niemals in öffentlichen Repos oder Frontend-Code ablegen. Every request must send the x-api-key: <your API key> header. You receive the key from matflixx sales after signing the contract. Treat it like a password, never commit it to public repos or expose it in front-end code.

FehlercodesError codes

Alle Endpoints folgen den Standard-HTTP-Status-Codes. Bei Fehlern enthält der Response-Body ein JSON mit error-Property. All endpoints follow standard HTTP status codes. On errors the response body contains JSON with an error property.

Code	BedeutungMeaning	MaßnahmeAction
`200`	OK	Erfolgreiche Anfrage.Successful request.
`400`	Ungültiger ParameterBad parameter	Bitte Parameter-Werte prüfen (Datum, ID, Format).Check parameter values (date, ID, format).
`401`	Auth fehltAuth missing	Header `x-api-key` nicht gesetzt.Header `x-api-key` not set.
`403`	Zugriff verweigertForbidden	API-Key ungültig oder Rohstoff nicht abonniert.API key invalid or commodity not subscribed.
`404`	Nicht gefundenNot found	Notierungs-ID existiert nicht.Quote-ID does not exist.
`429`	Rate Limit	Zu viele Requests, siehe Rate Limits.Too many requests, see Rate limits.
`500`	Server Error	Service-Störung, bitte service@matflixx.de informieren.Service outage, please contact service@matflixx.de.

Rate Limits & Caching

Standard-Tarife sind auf 600 Requests / Stunde pro API-Key limitiert. Bei Überschreitung antwortet die API mit 429 Too Many Requests. Quotes werden auf Server-Seite ~30 Sek. gecached, empfohlen ist Client-seitiges Caching bei lesenden Workloads. Bitte schließen Sie HTTP-Connections sauber (Connection: close oder Keep-Alive-Reuse), sonst können Sockets blockiert werden. Standard plans allow 600 requests / hour per API key. On overrun the API responds with 429 Too Many Requests. Quotes are server-cached for ~30s, client-side caching is recommended for read-heavy workloads. Please close HTTP connections cleanly (Connection: close or keep-alive reuse), otherwise sockets may be blocked.

GET /x-api/quotes

Liefert die aktuelle Notierung für einen oder mehrere Rohstoffe. Pflichtparameter: id. Optional: Einheit, Währung und Format umstellen. Returns the current quote for one or more commodities. Required: id. Optional: change unit, currency or format.

ParameterParameters

Name	Typ	BeschreibungDescription
`id`required	string	Notierungs-ID (z.B. `LME-CU-3M`). Mehrere IDs kommasepariert.Quote ID (e.g. `LME-CU-3M`). Multiple IDs comma-separated.
`fields`	string	Komma-separierte Feldauswahl (Default: `price`). Siehe Felder.Comma-separated field selection (default: `price`). See fields.
`Waehrung`	string	Ziel-Währung (Default: Original-Währung). Siehe Währungen.Target currency (default: native). See currencies.
`unit`	string	Ziel-Einheit innerhalb derselben Gruppe. Siehe Einheiten.Target unit within the same group. See units.
`f`	string	`json` (default), `xml`, `csv`

Code

BeispieleExamples

Mit Ziel-Währung EURWith target currency EUR

Mit Einheit KilogrammWith unit kg

Mit FeldauswahlWith field selection

Mit Format XMLWith format XML

Try it

id fields Waehrung unit f x-api-key

GET /x-api/timeseries

Liefert historische Kurse. Aggregations- und Zeitraum-Parameter sind kombinierbar. Returns historical quotes. Aggregation and time-range parameters can be combined.

ParameterParameters

Name	Typ	BeschreibungDescription
`id`required	string	Notierungs-ID.Quote ID.
`fields`	string	Komma-separierte Feldauswahl (Default: `price`). Siehe Felder.Comma-separated field selection (default: `price`). See fields.
`groupby`	string	`daily` \| `weekly` \| `monthly`
`timerange`	string	`50x`, `30x`, `2022-2024`, oder `YYYY-MM-DD`-Range.`50x`, `30x`, `2022-2024` or `YYYY-MM-DD` range.
`sort`	string	`asc` (default) · `desc`
`Waehrung`	string	Ziel-Währung.Target currency.
`unit`	string	Ziel-Einheit.Target unit.
`f`	string	`json`, `xml`, `csv`

BeispieleExamples

monthly

timerange 2022-2024

Alle Parameter kombiniert (CSV)All parameters combined (CSV)

Try it

id fields groupby timerange Waehrung unit f x-api-key

GET /x-api/futures

Liefert die vollständige Forward-Kurve eines Rohstoffs mit Liefermonaten und Notierungen. Returns the full forward curve of a commodity with delivery months and quotes.

ParameterParameters

Name	Typ	BeschreibungDescription
`id`required	string	Basis-ID des Rohstoffs (z.B. `LME-CU`).Commodity base ID (e.g. `LME-CU`).
`Waehrung` · `unit` · `f`	string	Wie bei `/quotes`.Same as `/quotes`.

GET /x-api/forecast

Liefert mittelfristige Preisprognosen für ausgewählte Rohstoffe. Ein Rohstoff kann mehrere Prognosen haben (z.B. verschiedene Modelle/Horizonte). Der Endpoint ist daher zweistufig: ohne forecast liefert er die Liste der verfügbaren Prognosen, mit forecast die Zeitreihe der gewählten Prognose. Hinweis: Prognosen werden monatlich aktualisiert. Returns mid-term price forecasts for selected commodities. A commodity can have multiple forecasts (e.g. different models/horizons), so the endpoint is two-step: without forecast it returns the list of available forecasts, with forecast it returns the chosen forecast's time series. Note: forecasts are updated monthly.

ParameterParameters

Name	Typ	BeschreibungDescription
`id`required	string	Notierungs-ID.Quote ID.
`forecast` · `forecast_id`	string	Slug der gewünschten Prognose (Feld `id` aus der Liste). Ohne diesen Parameter wird die Prognosen-Liste zurückgegeben.Slug of the desired forecast (the `id` from the list). Omit it to get the forecast list.
`groupby`	string	`daily` (default), `weekly`, `monthly`
`timerange`	string	`50x`, `2022-2024` oder `YYYY-MM-DD`-Range.`50x`, `2022-2024` or `YYYY-MM-DD` range.
`sort`	string	`asc` (default) · `desc`
`fields`	string	Feldauswahl, inkl. `source` (Prognose-Quelle je Datenpunkt). Siehe Felder.Field selection, incl. `source` (forecast source per point). See fields.
`Waehrung` · `unit` · `f`	string	Wie bei `/quotes` (`f` gilt auch für die Prognosen-Liste).Same as `/quotes` (`f` applies to the forecast list too).

Schritt 1 — Prognosen auflisten (ohne `forecast`)Step 1 — list forecasts (without `forecast`)

Liefert je Prognose einen Eintrag mit id (URL-sicherer Slug) und name (Quellenname). Den id als forecast zurückgeben, um die Zeitreihe zu holen. Returns one entry per forecast with id (URL-safe slug) and name (source name). Pass the id back as forecast to fetch the series.

GET /x-api/forecast?id=LME-CU-3M

{
  "forecasts": [
    { "id": "matflixx-forecast-12m-1", "name": "Matflixx forecast 12m-1" },
    { "id": "matflixx-forecast-4w-2",  "name": "Matflixx forecast 4w-2" }
  ]
}

Schritt 2 — Zeitreihe abrufen (mit `forecast`)Step 2 — fetch the series (with `forecast`)

BeispieleExamples

Verfügbare Prognosen auflistenList available forecasts

Monatlich + ZeitraumMonthly + range

Mit Prognose-Quelle (fields=source)With forecast source (fields=source)

GET /x-api/news

Liefert Marktnachrichten und MIS-Konjunkturberichte. Ohne Parameter erhalten Sie die neuesten Beiträge aller Kategorien. Returns market news and MIS economic reports. Without parameters you get the latest entries across all categories.

ParameterParameters

Name	Typ	BeschreibungDescription
`id`	string	Einzelne Nachricht per ID abrufen.Fetch a single news item by ID.
`category_id`	string	Kategorie-IDs, kommasepariert (z.B. `38,43,108`).Category IDs, comma-separated (e.g. `38,43,108`).
`grusel`	string	Spezial-Tag für MIS-Konjunkturreporte (z.B. `MSKKON`).Special tag for MIS economic reports (e.g. `MSKKON`).
`page`	number	Seitenindex (Default `0`).Page index (default `0`).
`page_size`	number	Einträge pro Seite (Default `50`).Entries per page (default `50`).

Neueste NachrichtenLatest news

Nach KategorienBy categories

MIS-Konjunkturberichte

Response-SchemasResponse schemas

Alle JSON-Antworten haben einen einheitlichen Wrapper mit Metadaten zum Request und den eigentlichen Daten unter data. All JSON responses share a common wrapper with request metadata and the actual payload under data.

/x-api/quotes: BeispielantwortExample response

{
  "meta": {
    "request_id": "a4b0…",
    "ts": "2026-05-16T08:12:34Z",
    "count": 1
  },
  "data": [
    {
      "id": "LME-CU-3M",
      "name": "LME Copper 3M",
      "value": 9482.50,
      "currency": "USD",
      "unit": "mt",
      "previous_close": 9445.00,
      "change_pct": 0.4,
      "ts": "2026-05-16T08:00:00Z"
    }
  ]
}

WährungenCurrencies

32 Währungen verfügbar. Konvertierungen erfolgen täglich gegen den EZB-Referenzkurs. 32 currencies available. Conversions are based on the daily ECB reference rate.

Code	Factor	Name (DE)	Name (EN)

EinheitenUnits

Konvertieren ist nur innerhalb derselben Gruppe möglich (Masse mit Masse, Volumen mit Volumen usw.). Conversion is only possible within the same group (mass to mass, volume to volume, etc.).

Unit	Name	Factor	Group

FelderFields

Mit fields wählen Sie die zurückgegebenen Werte (komma-separiert). Verfügbar für /quotes, /timeseries und /forecast. Ohne Angabe wird nur price geliefert. Deutsche Aliase werden akzeptiert; unbekannte Felder ergeben Fehler 400. Use fields to select the returned values (comma-separated). Available on /quotes, /timeseries and /forecast. If omitted, only price is returned. German aliases are accepted; unknown fields return error 400.

Field	Alias	AggregationAggregation	BeschreibungDescription
`price`	`letzter`	avg	Letzter Kurs (Default).Last price (default).
`settlement`	—	avg	Abrechnungskurs.Settlement price.
`bid`	`geld`	avg	Geldkurs.Bid price.
`ask`	`brief`	avg	Briefkurs.Ask price.
`open`	`erster`	first	Eröffnungskurs.Opening price.
`high`	`hoch`	max	Höchstkurs.High price.
`low`	`tief`	min	Tiefstkurs.Low price.
`volume`	`umsatz`	sum	Umsatz (keine Währungs-/Einheiten-Umrechnung).Volume (no currency/unit conversion).
`open_interest`	`oi`	last	Open Interest (keine Umrechnung).Open interest (no conversion).
`source`	—	—	Nur `/forecast`: Name der Prognose-Quelle je Datenpunkt.Only `/forecast`: name of the forecast source per data point.

SDKs & Tools

Es gibt aktuell kein offizielles SDK, die API ist bewusst schlank und kann mit jedem HTTP-Client direkt angesprochen werden. Unten ein Minimal-Beispiel zum Kopieren. There is no official SDK at the moment, the API is intentionally minimal and can be called with any HTTP client. Below a minimal example to copy.

Changelog

2026-06
/forecast: mehrere Prognosen pro Rohstoff — ohne forecast die Liste, mit forecast die Zeitreihe; zusätzlich groupby/timerange/sort. fields (inkl. source) für /quotes, /timeseries, /forecast; sort für /timeseries./forecast: multiple forecasts per commodity — without forecast a list, with forecast the series; plus groupby/timerange/sort. fields (incl. source) for /quotes, /timeseries, /forecast; sort for /timeseries.
2026-05
Neue Doku-Seite (ersetzt das alte PDF).New documentation page (replaces the old PDF).
2025-09
/forecast-Endpoint hinzugefügt./forecast endpoint added.
2025-03
timerange-Parameter erweitert (YYYY-YYYY).timerange parameter extended (YYYY-YYYY).

Fragen? Schreiben Sie uns an service@matflixx.de, wir helfen gerne weiter. Questions? Drop us a line at service@matflixx.de, happy to help.

Matflixx API-Dokumentation für Rohstoffdaten

API-DOKUMENTATIONDOCUMENTATION

ÜbersichtOverview

AuthentifizierungAuthentication

FehlercodesError codes

Rate Limits & Caching

GET /x-api/quotes

ParameterParameters

Code

BeispieleExamples

Try it

GET /x-api/timeseries

ParameterParameters

BeispieleExamples

Try it

GET /x-api/futures

ParameterParameters

GET /x-api/forecast

ParameterParameters

Schritt 1 — Prognosen auflisten (ohne `forecast`)Step 1 — list forecasts (without `forecast`)

Schritt 2 — Zeitreihe abrufen (mit `forecast`)Step 2 — fetch the series (with `forecast`)

BeispieleExamples

GET /x-api/news

ParameterParameters

Response-SchemasResponse schemas

WährungenCurrencies

EinheitenUnits

FelderFields

SDKs & Tools

Changelog

Matflixx API-Dokumentation für Rohstoffdaten

API-DOKUMENTATIONDOCUMENTATION

ÜbersichtOverview

AuthentifizierungAuthentication

FehlercodesError codes

Rate Limits & Caching

GET /x-api/quotes

ParameterParameters

Code

BeispieleExamples

Try it

GET /x-api/timeseries

ParameterParameters

BeispieleExamples

Try it

GET /x-api/futures

ParameterParameters

GET /x-api/forecast

ParameterParameters

Schritt 1 — Prognosen auflisten (ohne forecast)Step 1 — list forecasts (without forecast)

Schritt 2 — Zeitreihe abrufen (mit forecast)Step 2 — fetch the series (with forecast)

BeispieleExamples

GET /x-api/news

ParameterParameters

Response-SchemasResponse schemas

WährungenCurrencies

EinheitenUnits

FelderFields

SDKs & Tools

Changelog

Schritt 1 — Prognosen auflisten (ohne `forecast`)Step 1 — list forecasts (without `forecast`)

Schritt 2 — Zeitreihe abrufen (mit `forecast`)Step 2 — fetch the series (with `forecast`)