Wallet REST API

Ihre Finanzdaten lesen & verwalten

Lesen und verwalten Sie Ihre Wallet-Daten – Transaktionen, Konten, Budgets und mehr – aus Excel, Power BI, Skripten und Automatisierungstools über eine sichere REST API.

Vollständige API-ReferenzOpenAPI spec
Wallet REST API
GET
https://rest.budgetbakers.com/wallet
/v1/api/records?limit=30
Response:
{
"records": [
{
"id": "3643bf2e-…",
"counterParty": "Billa",
"amount": { "value": -612, "currencyCode": "CZK" },
"recordDate": "2026-06-09T11:09:00Z",
"category": { "name": "Groceries", … },
"recordType": "expense",
"paymentType": "debit_card"
}, …
]
}

Erste Schritte

1

Wallet Premium erwerben

Die REST API ist für Wallet Premium-Abonnenten verfügbar. Upgraden Sie Ihr Konto, um API-Zugriff freizuschalten.

2

API-Token generieren

Öffnen Sie die Einstellungen der Wallet-Web-App und generieren Sie Ihren persönlichen API-Token. Bewahren Sie ihn sicher auf – er gewährt Zugriff auf Ihre Daten.

3

Erste Anfrage senden

Beginnen Sie mit Basis-URL und Token, Ihre Finanzdaten abzufragen – probieren Sie es live im interaktiven API-Explorer aus.

Verfügbare Daten

Voller Lesezugriff auf alles – plus Erstellen, Aktualisieren und Löschen, wo es zählt.

Grundlegende Finanzdaten

GETPOSTPATCH/v1/api/records

Records

Transaktionen mit umfangreichen Filtern – bis zu 20 erstellen und 10 aktualisieren pro Anfrage

GETPOSTPATCH/v1/api/accounts

Accounts

Bankkonten, Karten und Bargeld – auflisten, neu anlegen, umbenennen und aktualisieren

GETPOSTPATCH/v1/api/categories

Categories

Der Kategoriebaum – eigene Unterkategorien anlegen und eigene umbenennen

Planung & Organisation

GETPOSTPATCH/v1/api/budgets

Budgets

Budgetdefinitionen und -verfolgung – erstellen und anpassen

GET/v1/api/goals

Goals

Sparziele und Fortschritt

GET/v1/api/standing-orders

Standing Orders

Wiederkehrende Zahlungen – /items listet die erzeugten Vorkommen

GETPOSTPATCH/v1/api/labels

Labels

Transaktions-Labels – auflisten, erstellen, umbenennen und umfärben

GET/v1/api/record-rules

Record Rules

Regeln zur automatischen Kategorisierung

Wartung & Monitoring

GET/v1/api/{type}/references

Entity References

Batch-Lookup verknüpfter Entitäten – eine sichere Vorprüfung vor dem Löschen

DELETE/v1/api/{type}

Delete Entities

Bis zu 10 Datensätze, Budgets, Konten, Labels und mehr pro Anfrage löschen

GET/v1/api/api-usage/stats

API Usage Stats

API-Nutzung und verbleibendes Kontingent überwachen

Schlüsselkonzepte

Paginierung

Steuern Sie Ergebnismengen mit limit- und offset-Parametern.

  • limit — bis zu 200 Ergebnisse pro Anfrage (Standard 30)
  • offset — N Ergebnisse überspringen
  • nextOffset — enthalten, wenn weitere Ergebnisse existieren

Filterung

Verwenden Sie typisierte Präfixe zur präzisen Datenfilterung.

  • eq., contains., contains-i. — Textfilter
  • gt., gte., lt., lte. — Bereichsvergleiche
  • Filter wiederholen (bis zu 2×) für UND-Bereiche

Rate Limits & Header

Token-Bucket-Limitierung, die kurze Lastspitzen erlaubt, mit klaren HTTP-Headern.

  • 300 Anfragen pro Stunde pro Client
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • 429 + Retry-After bei Drosselung

Batch-Schreibvorgänge

Schreiben Sie in kleinen, vorhersehbaren Batches – Elemente werden unabhängig verarbeitet.

  • POST /records — bis zu 20 Elemente
  • PATCH — bis zu 10 Elemente
  • DELETE — bis zu 10 IDs

Gut zu wissen

Währungsumrechnung

Die REST API nutzt für währungsübergreifende Operationen automatisch historische Wechselkurse. Die Umrechnung erfolgt nach dem Best-Effort-Prinzip – die Kurse stammen aus öffentlichen Marktdaten und können leicht von Bank- oder Wechselstubenkursen abweichen.

Summen & Sortierung

withTotal=true liefert zur Seite die Gesamtzahl der Treffer; sortBy sortiert nach jedem unterstützten Feld (+ aufsteigend, - absteigend).

Sync-Status

Ihr erster API-Token startet eine initiale Synchronisierung (Anfragen liefern 409, bis sie abgeschlossen ist). Danach zeigen die Header X-Last-Data-Change-At und X-Sync-In-Progress, wie aktuell die Daten sind.

Teilerfolg (HTTP 207)

Batch-Elemente werden unabhängig verarbeitet – gemischte Ergebnisse liefern eine Zusammenfassung pro Element. Mit validation=strict schlägt die Anfrage stattdessen sofort fehl.

Integrationsbeispiele

curl

Der einfachste Weg, die API vom Terminal aus zu testen.

curl -X GET "https://rest.budgetbakers.com/wallet/v1/api/records?limit=30" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Excel über Power Query

Importieren Sie Transaktionen direkt in Excel für individuelle Analyse und Berichterstattung.

  1. 1.Excel öffnen → Daten → Daten abrufen → Aus dem Web
  2. 2.Eingeben: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Authorization-Header mit Ihrem Bearer-Token hinzufügen
  4. 4.Daten transformieren und in die Tabelle laden

Power BI Dashboard

Erstellen Sie Echtzeit-Finanz-Dashboards mit automatischer Datenaktualisierung.

  1. 1.Web-Connector in Power BI Desktop verwenden
  2. 2.URL: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Bearer-Token-Authentifizierung konfigurieren
  4. 4.Geplante Aktualisierung einrichten und Visualisierungen erstellen

Python-Analyse

Analysieren Sie Ihre Finanzdaten programmatisch mit Python.

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
params = {
    'recordDate': 'gte.2025-01-01',
    'limit': 100
}

response = requests.get(
    'https://rest.budgetbakers.com/wallet/v1/api/records',
    headers=headers,
    params=params
)

data = response.json()
for rec in data['records']:
    amount = rec['amount']
    print(f"{rec['recordDate'][:10]} {rec['counterParty']}: "
          f"{amount['value']} {amount['currencyCode']}")

Bereit loszulegen?

Erkunden Sie die vollständige API-Referenz mit interaktiver Dokumentation, Anfragebeispielen und Antwortschemas.

Interaktiver API-ExplorerMCP-Integration testen