Konto

Konto

Rufe deine API-Kontodetails ab, einschließlich Balance, Overage-Einstellungen und Produktabos mit Nutzungszählern.

Endpunkt

Dieser Endpunkt liefert Kontodetails für den authentifizierten API-Key, inklusive verbleibender Balance, Overage-Konfiguration und den Produktabos mit der Nutzung im aktuellen Abrechnungszyklus.

GET   /v2/account

Authentifizierung

Übergib deinen API-Schlüssel als x-api-key Request-Header.

x-api-key: YourSecretAPIKey

Antwortfelder

FeldTypBeschreibung
balancenumberVerbleibendes vorausbezahltes Guthaben auf dem Konto, in Credits.
overageEnabledbooleanOb Overage-Abrechnung für dieses Konto aktiviert ist.
overageSpendingLimitnumberMaximale Overage, die das Konto in diesem Zyklus ansammeln darf, in Credits. 0 bedeutet kein Limit gesetzt.
subscriptionsobjectMap von Produkt-Key auf Abo-Objekt. Siehe Felder unten.

Felder pro Abo (jeder Wert unter subscriptions):

FeldTypBeschreibung
planIdstringPlan-Kennung (zum Beispiel steam-full, endpoint-2.5m, thirdparty-none).
startDatestring (ISO 8601)Wann der aktuelle Plan gestartet ist.
endDatestring (ISO 8601)Wann die aktuelle Planlaufzeit endet.
statusstringAbo-Status (zum Beispiel active).
autoRenewbooleanOb sich das Abo am nextRenewalDate automatisch erneuert.
pendingPlanIdstring | nullPlan, zu dem das Abo im nächsten Zyklus wechselt, falls vorhanden.
pendingChangeTypestring | nullTyp der anstehenden Änderung (Upgrade, Downgrade) oder null.
cycleStartDatestring (ISO 8601)Beginn des aktuellen Abrechnungszyklus.
nextRenewalDatestring (ISO 8601)Nächstes geplantes Erneuerungsdatum.
usageobjectMap von Endpoint-Pfad oder Nutzungskategorie auf Anzahl der verbrauchten Requests in diesem Zyklus.
billedOveragenumberOverage-Betrag, der in diesem Zyklus bereits abgerechnet wurde, in Credits.

Abo-Produkte und Pläne

Das subscriptions-Objekt ist nach Produktkategorie indiziert. Jedes Produkt hat eigene Pläne; die planId-Werte gelten jeweils nur innerhalb ihrer Produktkategorie.

STEAM_DATA

Kern-Quota für Steam-Daten (Profile, Inventare, Apps, Items).

Plan-IDPreisIntervall
steam-noneKostenlosMonat
steam-30days€4.99Monat
steam-180days€19.99Monat
steam-full€29.99Monat

EXTRA_REQUESTS

Zusätzliche Request-Quota zusätzlich zum Basisplan. Monatlicher Preis mit Overage pro Request.

Plan-IDMax. RequestsPreisIntervall
endpoint-none500Kostenlospro Request
endpoint-100k100.000€9.99Monat
endpoint-250k250.000€24.99Monat
endpoint-500k500.000€44.99Monat
endpoint-1m1.000.000€89.99Monat
endpoint-2.5m2.500.000€189.99Monat
endpoint-10m10.000.000€599.99Monat
endpoint-40m40.000.000€1.799,99Monat

THIRD_PARTY_MARKET_DATA

Zugriff auf Marktdaten von Drittanbietern.

Plan-IDPreisIntervall
thirdparty-noneKostenlosMonat
thirdparty-data€49.99Monat
thirdparty-data-history-15€54.99Monat
thirdparty-data-history-30€69.99Monat
thirdparty-data-history-180€99.99Monat

THIRD_PARTY_ADDON_SALES

Add-on für Verkaufsdaten von Drittanbietern.

Plan-IDPreisIntervall
addons-sales€49.99Monat

THIRD_PARTY_ADDON_WSS

Add-on für den WebSocket-Stream von Drittanbietern.

Plan-IDPreisIntervall
addons-wss€39.99Monat

Plan-IDs und Preise können sich mit der Zeit ändern. Behandle die planId als opake Kennung im Rahmen ihrer Produktkategorie.

Antwort-Beispiel

response.json
{
  "success": true,
  "result": {
    "balance": 493177.0881900459,
    "overageEnabled": true,
    "overageSpendingLimit": 0,
    "subscriptions": {
      "STEAM_DATA": {
        "planId": "steam-full",
        "startDate": "2026-01-19T03:35:35.815Z",
        "endDate": "2026-05-19T03:35:35.815Z",
        "status": "active",
        "autoRenew": true,
        "pendingPlanId": null,
        "pendingChangeType": null,
        "cycleStartDate": "2026-01-19T03:35:35.815Z",
        "nextRenewalDate": "2026-05-19T03:35:35.815Z",
        "usage": {
          "steam/inventory": 122935,
          "steam/profile": 83223,
          "market/items": 276,
          "market/item": 20928,
          "/v2/steam/users/:steamid": 5,
          "/v2/steam/apps/:appId": 5
        },
        "billedOverage": 0
      },
      "EXTRA_REQUESTS": {
        "planId": "endpoint-2.5m",
        "startDate": "2026-01-19T03:35:36.067Z",
        "endDate": "2026-05-19T03:35:35.815Z",
        "status": "active",
        "autoRenew": true,
        "pendingPlanId": null,
        "pendingChangeType": null,
        "cycleStartDate": "2026-01-19T03:35:35.815Z",
        "nextRenewalDate": "2026-05-19T03:35:35.815Z",
        "usage": {
          "steam/profile": 83223,
          "steam/inventory": 122476,
          "market/item": 20928,
          "/v2/steam/apps": 1,
          "/v2/steam/users/:steamid/friends": 1
        },
        "billedOverage": 0
      },
      "THIRD_PARTY_MARKET_DATA": {
        "planId": "thirdparty-none",
        "startDate": "2026-01-19T03:38:43.170Z",
        "endDate": "2026-05-19T03:35:35.815Z",
        "status": "active",
        "autoRenew": true,
        "pendingPlanId": null,
        "pendingChangeType": null,
        "cycleStartDate": "2026-01-19T03:35:35.815Z",
        "nextRenewalDate": "2026-05-19T03:35:35.815Z",
        "usage": {
          "market/items": 276,
          "market/item": 20928
        },
        "billedOverage": 0
      }
    }
  }
}