Skip to content
ClawHosters ClawHosters
Anmelden Jetzt starten
Abo -25% LAUNCH-SUB
Claws -25% LAUNCH-CLAWS

API: Abrechnungs-Endpunkte

5 min Lesezeit API Zuletzt aktualisiert 10. February 2026

Überblick

Die Abrechnungs-Endpunkte ermöglichen dir, dein Claws-Guthaben zu prüfen, Kostenaufschlüsselungen einzusehen, Transaktionen zu durchsuchen und Claws-Pakete zu kaufen. Alle Abrechnungs-Endpunkte erfordern Authentifizierung.

Abrechnungszusammenfassung abrufen

text 
GET /api/v1/billing/summary

Gibt dein aktuelles Guthaben, tägliche Kosten und Abonnement-Status zurück.

Beispiel:

bash 
curl -X GET https://clawhosters.com/api/v1/billing/summary \
  -H "Authorization: Bearer oc_live_dein_api_schlüssel"

Erfolgsantwort (200 OK):

json 
{
  "data": {
    "claws_balance": 1500,
    "daily_claw_cost": 225,
    "days_remaining": 6,
    "low_balance": false,
    "subscription_status": "active",
    "subscription_tier": "balanced",
    "instances_count": 2,
    "running_instances_count": 1
  }
}

Antwort-Felder

Feld Typ Beschreibung
claws_balance integer Aktuelles Claws-Guthaben
daily_claw_cost integer Täglicher Claws-Verbrauch aller laufenden Instanzen und Add-ons
days_remaining integer Geschätzte Tage bis das Guthaben bei aktuellem Verbrauch aufgebraucht ist
low_balance boolean Ob das Guthaben unter der Warnschwelle liegt
subscription_status string Aktueller Abonnement-Status: active, paused oder canceled
subscription_tier string Preisstufe bei aktivem Abo: budget, balanced, pro oder none
instances_count integer Gesamtzahl der Instanzen auf deinem Account
running_instances_count integer Anzahl aktuell laufender Instanzen

Nutzungsdetails abrufen

text 
GET /api/v1/billing/usage

Gibt eine Aufschlüsselung der täglichen Claws-Kosten nach Instanz und Add-on zurück.

Beispiel:

bash 
curl -X GET https://clawhosters.com/api/v1/billing/usage \
  -H "Authorization: Bearer oc_live_dein_api_schlüssel"

Erfolgsantwort (200 OK):

json 
{
  "data": {
    "daily_total": 270,
    "instances": [
      {
        "id": 42,
        "name": "my-ai-bot",
        "tier": "balanced",
        "daily_claws": 225,
        "status": "running",
        "billing_mode": "daily"
      }
    ],
    "addons": [
      {
        "id": 7,
        "addon_type": "llm",
        "instance_name": "my-ai-bot",
        "tier": "gpt4",
        "current_usage": 5000,
        "usage_limit": 10000,
        "daily_claws": 45
      }
    ]
  }
}

Instanz-Felder

Feld Typ Beschreibung
id integer Instanz-ID
name string Instanz-Name
tier string Instanz-Stufe: budget, balanced oder pro
daily_claws integer Tägliche Claws-Kosten für diese Instanz
status string Aktueller Instanz-Status
billing_mode string daily oder subscription

Add-on-Felder

Feld Typ Beschreibung
id integer Add-on-ID
addon_type string Typ: llm, voice, embeddings oder backup
instance_name string Name der zugehörigen Instanz
tier string Add-on-Stufe oder Paketgröße
current_usage integer Aktueller monatlicher Verbrauch
usage_limit integer Monatliches Nutzungslimit
daily_claws integer Tägliche Claws-Kosten für dieses Add-on

Transaktionen auflisten

text 
GET /api/v1/billing/transactions

Gibt eine paginierte Liste von Abrechnungstransaktionen zurück. Unterstützt Datumsfilterung.

Abfrageparameter

Parameter Typ Standard Beschreibung
page integer 1 Seitennummer
per_page integer 20 Ergebnisse pro Seite (max 100)
start_date string — Ab diesem Datum filtern (YYYY-MM-DD)
end_date string — Bis zu diesem Datum filtern (YYYY-MM-DD)

Beispiel:

bash 
curl -X GET "https://clawhosters.com/api/v1/billing/transactions?page=1&per_page=10" \
  -H "Authorization: Bearer oc_live_dein_api_schlüssel"

Erfolgsantwort (200 OK):

json 
{
  "data": {
    "transactions": [
      {
        "id": 301,
        "transaction_type": "daily_deduction",
        "claws_amount": -225,
        "amount_cents": 150,
        "description": "Daily hosting for my-ai-bot (Balanced)",
        "instance_id": 42,
        "created_at": "2026-02-10T00:00:00Z"
      },
      {
        "id": 298,
        "transaction_type": "purchase",
        "claws_amount": 250,
        "amount_cents": 5900,
        "description": "Claws purchase: Popular Pack",
        "instance_id": null,
        "created_at": "2026-02-09T14:22:10Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 5,
      "total_count": 47,
      "per_page": 10
    }
  }
}

Transaktions-Felder

Feld Typ Beschreibung
id integer Transaktions-ID
transaction_type string Typ: daily_deduction, purchase, refund, subscription oder system
claws_amount integer Claws hinzugefügt (positiv) oder abgezogen (negativ)
amount_cents integer EUR-Betrag in Cent
description string Lesbare Beschreibung
instance_id integer oder null Zugehörige Instanz, falls zutreffend
created_at string ISO 8601 Zeitstempel

Transaktionstypen

Typ Beschreibung
daily_deduction Automatische tägliche Abrechnung für laufende Instanzen und Add-ons
purchase Manueller Claws-Paketkauf
refund Erstattung auf dein Konto
subscription Monatliche Abonnement-Belastung
system Administrative Anpassung

Claws-Pakete auflisten

text 
GET /api/v1/billing/packages

Gibt die verfügbaren Claws-Pakete zum Kauf zurück.

Beispiel:

bash 
curl -X GET https://clawhosters.com/api/v1/billing/packages \
  -H "Authorization: Bearer oc_live_dein_api_schlüssel"

Erfolgsantwort (200 OK):

json 
{
  "data": {
    "packages": [
      {
        "index": 0,
        "name": "Starter Pack",
        "price_cents": 2900,
        "price_eur": "29.00",
        "claws": 100,
        "bonus_percent": 0
      },
      {
        "index": 1,
        "name": "Popular Pack",
        "price_cents": 5900,
        "price_eur": "59.00",
        "claws": 250,
        "bonus_percent": 20
      }
    ]
  }
}

Paket-Felder

Feld Typ Beschreibung
index integer Paket-Kennung für den Kauf-Endpunkt
name string Anzeigename
price_cents integer Preis in EUR Cent
price_eur string Formatierter Preis in EUR
claws integer Anzahl der Claws im Paket
bonus_percent integer Bonus-Prozentsatz (0 wenn kein Bonus)

Claws kaufen

text 
POST /api/v1/billing/buy_claws

Startet einen Claws-Kauf über Stripe Checkout. Gibt eine Checkout-URL zurück, zu der der Kunde weitergeleitet wird.

Request-Body:

json 
{
  "package_index": 1,
  "widerrufsrecht_waived": true
}
Parameter Typ Erforderlich Beschreibung
package_index integer Ja Index aus dem Pakete-Endpunkt
widerrufsrecht_waived boolean Ja Muss true sein (Widerrufsrecht-Verzicht nach deutschem Recht)

Beispiel:

bash 
curl -X POST https://clawhosters.com/api/v1/billing/buy_claws \
  -H "Authorization: Bearer oc_live_dein_api_schlüssel" \
  -H "Content-Type: application/json" \
  -d '{"package_index": 1, "widerrufsrecht_waived": true}'

Erfolgsantwort (200 OK):

json 
{
  "data": {
    "checkout_url": "https://checkout.stripe.com/pay/cs_live_...",
    "package": {
      "name": "Popular Pack",
      "claws": 250,
      "price_cents": 5900
    }
  }
}

Die checkout_url leitet den Kunden zu Stripe für die Zahlung weiter. Nach erfolgreicher Zahlung werden die Claws automatisch dem Konto gutgeschrieben.

Authentifizierung

Alle Abrechnungs-Endpunkte erfordern einen gültigen API-Schlüssel:

text 
Authorization: Bearer oc_live_dein_api_schlüssel

Fehlerantworten

Ungültiges Paket (422)

json 
{
  "error": {
    "code": "unprocessable_entity",
    "message": "Invalid package index. Please select a valid Claw package."
  }
}

Fehlender Widerrufsrecht-Verzicht (422)

json 
{
  "error": {
    "code": "unprocessable_entity",
    "message": "You must waive your right of withdrawal to proceed with the purchase."
  }
}

Nicht autorisiert (401)

json 
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

Hinweise

  • Die Abrechnungszusammenfassung wird in Echtzeit aktualisiert, wenn Instanzen gestartet oder gestoppt werden.
  • Der Transaktionsverlauf ist nach dem neuesten Eintrag sortiert.
  • Tägliche Abzüge erfolgen um Mitternacht UTC. Jede laufende Instanz und jedes aktive Add-on erzeugt eine separate Transaktion.
  • Das Feld days_remaining ist eine Schätzung basierend auf den aktuellen täglichen Kosten. Es ändert sich, wenn du Instanzen startest oder stoppst.
  • Über buy_claws gekaufte Claws werden deinem Konto gutgeschrieben, sobald Stripe die Zahlung bestätigt.

Verwandte Dokumentation

Verwandte Dokumentation

API-Übersicht

Einführung Die ClawHosters-API ermöglicht es dir, deine Instanzen zu verwalten, Abrechnungen ein...

Abrechnungsübersicht

Wie die Abrechnung funktioniert ClawHosters bietet zwei Abrechnungsmodi: Monatsabonnements und t...

Deine Rechnung verstehen

Wo du deine Rechnungen findest Alle Rechnungen sind in deinem ClawHosters-Dashboard verfügbar: ...