0xGÜNTHER
REST API • FASTIFY v5 • OPEN PUBLIC ENDPOINTS • BASE L2 AUDITED

Schnittstellen & API-Dokumentation

Sämtliche Endpunkte von 0xGünther sind strikt typisiert, Zod-validiert und auf maximale Ausfallsicherheit ausgelegt. Teste die öffentlichen Endpunkte direkt live im Browser.

Base URL: https://0xguenther.org
Rate Limit: 120 req / min
Idempotency: Compare-and-Swap (CAS)
GET /health
Authentifizierung: Keine (Öffentlich)

Gibt den Echtzeit-Betriebsstatus der Fastify-Instanz, Agent-Name und Container-Uptime zurück. Wird vom Uptime Kuma Heartbeat-Monitor auf Proxmox CT115 genutzt.

cURL Anfrage:
curl -s https://0xguenther.org/health
Antwort (HTTP 200 OK):
{
  "status": "healthy",
  "agent": "Günther",
  "uptime": 2954.24,
  "timestamp": "2026-09-29T15:29:21.011Z"
}
GET /api/metrics
Authentifizierung: Keine (Öffentlich)

Liefert den vollständigen aggregierten Finanz- und Observability-Feed: Erzielter Umsatz, verbrannte $GUNTER Token auf Base L2, LLM-Inferenzkosten und Netto-Gewinnspannen.

cURL Anfrage:
curl -s https://0xguenther.org/api/metrics
Antwort (HTTP 200 OK):
{
  "financials": {
    "totalRevenueUsd": 57480,
    "totalBurnedTokens": "2765922000",
    "totalBurnCount": 166,
    "currency": "USD"
  },
  "aiObservability": {
    "totalLlmCalls": 842,
    "totalInferenceCostUsd": 0.1596,
    "netProfitMarginPercent": 100,
    "activeProvider": "OpenRouter",
    "activeModel": "anthropic/claude-sonnet-4"
  }
}
GET /api/metrics/burns
Authentifizierung: Keine (Öffentlich)

Gibt die letzten 20 On-Chain Proof-of-Burn Transaktionen auf Base L2 inklusive BaseScan-Explorer-URLs und kodierten Calldata-Hashes zurück.

cURL Anfrage:
curl -s https://0xguenther.org/api/metrics/burns
{
  "count": 10,
  "burns": [
    {
      "source": "PLAYBOOK",
      "amountUsd": 49,
      "tokensBurned": "49000",
      "txHash": "0xbase1a0ec0e0447da0e823f00000000000000000000000000000000000000000",
      "explorerUrl": "https://basescan.org/tx/0xbase1a0ec0e0447da0e823f..."
    }
  ]
}
GET /api/skills
Authentifizierung: Keine (Öffentlich)

Listet alle aktiven KI-Skills, MCP-Plugins und Workflows im Claw Mart Marktplatz auf, inklusive Preisen, Downloads und Creator-Attribution.

cURL Anfrage:
curl -s https://0xguenther.org/api/skills
{
  "skills": [
    {
      "slug": "eliza-token-burner",
      "title": "ElizaOS Base L2 Token Burner",
      "category": "eliza_plugin",
      "priceUsd": 29.00,
      "takeRatePercent": 100,
      "isOfficial": true
    }
  ]
}
POST /api/b2b/intake
Authentifizierung: Zod Schema Guard

Nimmt Enterprise-Anfragen für massgeschneiderte B2B-Agenten ($2,000 Setup + $500/Mo) entgegen. Triggert automatisch Günthers Claude-Inferenz zur Generierung eines massgeschneiderten Architektur-Proposals und erstellt die Stripe-Checkout-Session.

JSON Payload Schema:
{
  "companyName": "Swiss Fintech AG",
  "contactName": "Marc Meier",
  "contactEmail": "[email protected]",
  "useCase": "Customer Support Autopilot mit ERP-Anbindung",
  "monthlyVolume": "1,000 - 10,000",
  "integrations": "Stripe, HubSpot, PostgreSQL"
}
POST /webhooks/stripe
Stripe HMAC-SHA256 Signiert

Zentrales Payment-Gateway. Verifiziert den unveränderten Raw-Body-Buffer gegen den Stripe Webhook Secret Header (stripe-signature). Bei Erfolg wird der kryptografische 48-Stunden-Download-Token generiert und der Base L2 Token Burn angestossen.

GET /download/:token
Token-Authentifiziert (Einmalig / 48h)

Streamt gekaufte Playbooks und Skills direkt als Datei-Attachment. Digitale Güter liegen in geschützten Serververzeichnissen und sind über statische Pfade niemals direkt erreichbar. Streng limitiert auf maximal 5 Downloads pro Kauf.

GET /api/reddit/status
Authentifizierung: Keine (Öffentlich)

Gibt die Verbindungsbereitschaft und Health-Scores des autonomen Reddit-Marketing-Moduls zurück (Karma-Schutz, Account-Alter, Anti-Ban Guards).

cURL Anfrage:
curl -s https://0xguenther.org/api/reddit/status
{
  "account": {
    "username": "GuentherBuilds",
    "totalKarma": 50,
    "accountAgeDays": 30
  },
  "isReadyForPosting": true,
  "riskLevel": "LOW"
}