Die ieUnit-API

Das Widget – mit einer Zeile eingebettet

Wer den aktuellen ieUnit-Wert auf der eigenen Seite zeigen will, bindet das fertige Widget ein. Es holt den Wert live von der API, ist gekapselt (kein Eingriff in Dein CSS) und braucht keine Konfiguration. Es gibt es in zwei Varianten:

Variante 1 – fester Wert

<div class="ieunit-widget" data-currency="CHF" data-chart="true"></div>
<script src="https://ieunit.org/assets/js/ieunit-widget.js" async></script>

Variante 2 – mit Einheiten-Auswahl

<div class="ieunit-widget" data-picker="true" data-chart="true"></div>
<script src="https://ieunit.org/assets/js/ieunit-widget.js" async></script>

iframe-Alternative (voll isoliert, für beide Varianten – Auswahl mit &picker=1):

<iframe src="https://ieunit.org/embed/ieunit.html?picker=1&chart=1"
        width="320" height="200" style="border:0" loading="lazy"
        title="ieUnit Live-Wert"></iframe>

value – aktueller Wert

Liefert den aktuellen ieUnit-Referenzwert. Der optionale Parameter currency (USD · CHF · EUR) legt das Feld value fest; values enthält ohnehin alle drei.

{
  "unit": "ieUnit",
  "date": "2026-06-12",
  "value": 3.03,
  "currency": "CHF",
  "values": { "USD": 3.79, "CHF": 3.03, "EUR": 3.28 },
  "change_24h_pct": -0.27,
  "method": "geometric_mean",
  "base_date": "2017-01-10",
  "source": "live",
  "updated_at": "2026-06-12T10:35:29Z",
  "disclaimer": "Referenzwert, kein Zahlungsmittel und keine Anlageberatung."
}

source ist live, sobald der tägliche Cron lief, sonst backfill. updated_at ist der UTC-Zeitstempel des letzten Laufs.

history – Verlauf seit 2017

{
  "unit": "USD", "base_date": "2017-01-10", "step": "month", "count": 114,
  "series": [
    ["2017-01-10", 1.0000],
    ["2017-02-28", 1.0431],
    ["2026-06-12", 3.79]
  ]
}

components – Tagespreise der Korb-Werte

Tagespreise der neun Korb-Werte in USD je Einheit (Gold/Silber je Feinunze, 31,1034768 g). Parameter wie bei history, zusätzlich only für eine kommagetrennte Auswahl.

{
  "unit": "USD_per_unit", "ounce_g": 31.1034768, "step": "month",
  "dates": ["2017-01-10", "..."],
  "series": { "BTC": [907.68, "..."], "Gold": [1184.20, "..."] }
}

basket – Korb-Definition

Die unveränderliche Korb-Definition mit den fixen Referenzpreisen am Basiszeitpunkt – damit lässt sich der ieUnit jederzeit unabhängig nachrechnen.

{
  "base_date": "2017-01-10", "start_value": 1.0, "internal_unit": "USD",
  "method": "geometric_mean",
  "components": ["USD","EUR","JPY","CHF","CNH","BTC","ETH","Gold","Silber"],
  "reference_prices_usd": { "USD": 1.0, "EUR": 1.05886209, "BTC": 907.67901611, "...": 0 }
}

rates – Umrechnungskurse

Aktuelle Umrechnungskurse (USD je Einheit) für den Rechner: rund 30 Fiat-Währungen, die Top-30-Kryptowährungen, Gold/Silber je Gramm sowie XIN (Sonderfall, letzter Börsenkurs 1 Satoshi, Delisting 22.02.2022) – plus der aktuelle ieUnit-Wert in USD.

MCP – für KI-Assistenten

Neben der klassischen API gibt es den ieUnit auch als MCP-Server. MCP steht für «Model Context Protocol» und ist der offene Standard, über den KI-Assistenten wie Claude oder ChatGPT externe Werkzeuge nutzen. Der Unterschied zur API oben: Eine API muss jemand kennen und einbauen – einen MCP-Server benutzt die KI von sich aus, sobald er einmal eingerichtet ist. Fragt jemand «Was sind 250 Franken in ieUnit?» oder «Wie hat sich Gold gegenüber dem ieUnit gehalten?», holt sich der Assistent die Antwort direkt hier – statt zu raten.

Der Server stellt sechs Werkzeuge bereit:

Das letzte Werkzeug hat einen besonderen Zweck: Es liefert der KI die verbindliche Definition mit – also auch die Klarstellung, dass der ieUnit keine Währung, kein Stablecoin und ohne Peg ist. So beschreiben Assistenten den ieUnit so, wie er gemeint ist.

Einrichten – der einfachste Weg

Du musst keine Befehle kennen. Wenn Du mit einem KI-Assistenten arbeitest, der auf Deine Kommandozeile zugreifen kann – etwa Claude Code, Codex oder die Gemini CLI –, dann sag ihm einfach das hier:

Füge den MCP-Server «ieunit» mit der URL https://ieunit.org/mcp/ zu meiner
Konfiguration hinzu – projektübergreifend und ohne Authentifizierung.
Prüfe anschliessend, ob er erkannt wird.

Der Assistent wählt den richtigen Befehl und die richtige Datei selbst.

Danach einmal neu starten. Die meisten Anwendungen lesen die MCP-Server beim Programmstart ein – ein Eintrag, der währenddessen dazukommt, wird erst im nächsten Gespräch sichtbar. Das gilt für Claude Code, Codex und die Gemini CLI gleichermassen.

Einrichten von Hand

MCP ist herstellerunabhängig – der Server lässt sich in jeder Anwendung eintragen, die das Protokoll unterstützt. Die gängigen Kommandozeilen-Werkzeuge:

Der Zusatz --scope user macht den Eintrag projektübergreifend – ohne ihn gilt er nur im aktuellen Ordner. Codex kennt diese Unterscheidung nicht und speichert grundsätzlich global, dort entfällt der Zusatz.

Anwendungen mit Oberfläche – etwa Claude Desktop oder ChatGPT – haben die Einstellung unter «Connectors», «Apps» oder «MCP-Server». Dort einen neuen Eintrag anlegen, die Server-URL eintragen und «keine Authentifizierung» wählen. Wer eine Konfigurationsdatei pflegt, nimmt diesen Block:

{
  "mcpServers": {
    "ieunit": {
      "type": "http",
      "url": "https://ieunit.org/mcp/"
    }
  }
}

Dieser Block gilt für Claude Desktop und kompatible Anwendungen. Die Gemini CLI schreibt stattdessen "httpUrl" statt "type" und "url" – am einfachsten nimmst Du dort den Befehl aus der Tabelle, dann wird die Datei richtig geschrieben.

Danach genügt eine Frage in normaler Sprache – der Assistent wählt das passende Werkzeug selbst.

Direkt ausprobieren lässt sich der Server auch von Hand:

curl -s https://ieunit.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/list" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list",
        "params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

Es gelten dieselben Nutzungsbedingungen wie für die API: kostenlos, frei nutzbar, mit Quellenangabe.

Code-Beispiele

curl

curl -s https://ieunit.org/api/v1/value.php?currency=CHF

JavaScript (fetch)

const r = await fetch('https://ieunit.org/api/v1/value.php?currency=CHF');
const d = await r.json();
console.log(`1 ieUnit = ${d.value} ${d.currency}`);

Python

import urllib.request, json
url = 'https://ieunit.org/api/v1/history.php?step=month'
with urllib.request.urlopen(url) as r:
    hist = json.load(r)
print(hist['count'], 'Datenpunkte seit', hist['base_date'])

Nutzungsbedingungen

• Kostenlos und offen: API und Widgets dürfen frei genutzt, eingebunden und weiterverarbeitet werden, auch kommerziell.
• Quellenangabe (CC BY 4.0): Bitte ieUnit als Quelle nennen und auf ieunit.org verlinken.
• Keine Gewähr: Die Werte sind regelbasierte Referenzwerte – kein Zahlungsmittel, keine Anlageberatung. ieWerk haftet nicht für Richtigkeit oder Verfügbarkeit.
• Fair-Use: höchstens stündlich abfragen oder die Antwort zwischenspeichern. Die Daten ändern sich nur einmal pro Tag.
• Stabilität: Die URLs unter /api/v1/ bleiben stabil; Erweiterungen erfolgen abwärtskompatibel.

API-Dokumentation als PDF