IBANforge

API-Schluessel

IBANforge bietet ein kostenloses Kontingent ueber API-Schluessel — 200 Anfragen/Monat auf allen Endpunkten. Keine Kreditkarte, keine Krypto-Wallet erforderlich. Fuer hoehere Volumen koennen Sie x402-Mikrozahlungen verwenden.

Kostenlosen API-Schluessel generieren

Senden Sie eine POST-Anfrage an /v1/keys/generate mit Ihrer E-Mail-Adresse:

curl -X POST https://api.ibanforge.com/v1/keys/generate \
  -H "Content-Type: application/json" \
  -d '{"email": "sie@beispiel.de"}'

Antwort

{
  "key": "ifk_live_xxxxxxxxxxxxxxxxxxxx",
  "email": "sie@beispiel.de",
  "tier": "free",
  "quota": {
    "requests_per_month": 200,
    "used": 0,
    "resets_at": "2026-05-01T00:00:00.000Z"
  }
}

Ihr Schluessel beginnt mit ifk_ (IBANforge Key). Bewahren Sie ihn sicher auf — er wird nicht erneut angezeigt.

Ihren API-Schluessel verwenden

Uebermitteln Sie den Schluessel im Authorization-Header als Bearer-Token:

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ifk_live_xxxxxxxxxxxxxxxxxxxx" \
  -d '{"iban": "CH93 0076 2011 6238 5295 7"}'

Der Schluessel funktioniert auf allen kostenpflichtigen Endpunkten:

  • POST /v1/iban/validate
  • POST /v1/iban/batch
  • GET /v1/bic/:code
  • POST /v1/iban/compliance
  • GET /v1/ch/clearing/:iid

Die Angebote im Überblick

PlanVolumenKosten
Kostenlos (API-Schluessel)200 Anfragen/Monat$0
Prepaid-Guthabenpakete — Karte oder USDC1k / 5k / 25k Aufrufe$5 / $20 / $80 — verfallen nie
x402 Pay-per-CallUnbegrenzt$0,002–$0,02/Aufruf

Die 200 kostenlosen Anfragen werden ueber alle Endpunkte geteilt und setzen sich am 1. jedes Monats zurueck.

Ihre Nutzung pruefen

curl https://api.ibanforge.com/v1/keys/usage \
  -H "Authorization: Bearer ifk_live_xxxxxxxxxxxxxxxxxxxx"

Antwort

{
  "tier": "free",
  "quota": {
    "requests_per_month": 200,
    "used": 47,
    "remaining": 153,
    "resets_at": "2026-05-01T00:00:00.000Z"
  }
}

Wenn Ihr Kontingent erschoepft ist

Ihre Integration landet nicht in einer Sackgasse. Sind die 200 monatlichen Anfragen aufgebraucht, antwortet die API mit 402 Payment Required (x402) statt einem harten 429 — mit Hinweis-Headern, die genau sagen, was passiert ist:

X-Quota-Exhausted: true
X-Quota-Used: 200
X-Quota-Limit: 200
X-Quota-Month: 2026-07

Der 402-Body listet Ihre drei Optionen maschinenlesbar auf:

  1. Prepaid-Guthabenpaket kaufen — per Karte auf der Preisseite oder in USDC via POST /v1/credits/buy/1k|5k|25k. Guthaben verfällt nie und wird an Ihren bestehenden Schlüssel gebunden.
  2. Pay-per-Call via x402 — ein x402-kompatibler Client zahlt automatisch in USDC, ohne Schlüsselwechsel. Siehe x402-Zahlungen.
  3. Auf den monatlichen Reset warten — das Kontingent setzt sich am 1. jedes Monats zurueck.

TypeScript-Beispiel

const API_KEY = process.env.IBANFORGE_API_KEY;
 
const response = await fetch("https://api.ibanforge.com/v1/iban/validate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${API_KEY}`,
  },
  body: JSON.stringify({ iban: "CH93 0076 2011 6238 5295 7" }),
});
 
const data = await response.json();
console.log(data);

Python-Beispiel

import os
import requests
 
API_KEY = os.environ["IBANFORGE_API_KEY"]
 
response = requests.post(
    "https://api.ibanforge.com/v1/iban/validate",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {API_KEY}",
    },
    json={"iban": "CH93 0076 2011 6238 5295 7"},
)
 
data = response.json()
print(data)

Naechste Schritte