Wallet REST API

Читайте й керуйте своїми фінансовими даними

Читайте й керуйте даними Wallet — транзакціями, рахунками, бюджетами та іншим — з Excel, Power BI, скриптів та інструментів автоматизації через захищений REST API.

Повна довідка APIOpenAPI 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"
}, …
]
}

Початок роботи

1

Отримайте Wallet Premium

REST API доступний для підписників Wallet Premium. Оновіть свій обліковий запис, щоб отримати доступ до API.

2

Згенеруйте API токен

Відкрийте Налаштування у веб-застосунку Wallet і згенеруйте персональний API-токен. Тримайте його в безпеці — він надає доступ до ваших даних.

3

Зробіть перший запит

Використовуйте базову URL-адресу й токен, щоб почати запитувати свої фінансові дані — спробуйте наживо в інтерактивному оглядачі API.

Доступні дані

Повний доступ на читання до всього — і створення, оновлення та видалення там, де це важливо.

Основні фінансові дані

GETPOSTPATCH/v1/api/records

Records

Транзакції з гнучкими фільтрами — створюйте до 20 і оновлюйте до 10 за один запит

GETPOSTPATCH/v1/api/accounts

Accounts

Банківські рахунки, картки та готівка — переглядайте, відкривайте нові, перейменовуйте й оновлюйте

GETPOSTPATCH/v1/api/categories

Categories

Дерево категорій — додавайте власні підкатегорії та перейменовуйте свої

Планування та організація

GETPOSTPATCH/v1/api/budgets

Budgets

Визначення бюджетів і відстеження — створюйте та коригуйте їх

GET/v1/api/goals

Goals

Цілі заощаджень і прогрес

GET/v1/api/standing-orders

Standing Orders

Регулярні платежі — /items показує згенеровані повторення

GETPOSTPATCH/v1/api/labels

Labels

Мітки транзакцій — переглядайте, створюйте, перейменовуйте та змінюйте кольори

GET/v1/api/record-rules

Record Rules

Правила автоматичної категоризації

Обслуговування та моніторинг

GET/v1/api/{type}/references

Entity References

Пакетний пошук пов’язаних сутностей — безпечна перевірка перед видаленням

DELETE/v1/api/{type}

Delete Entities

Видаляйте до 10 записів, бюджетів, рахунків, міток тощо за один запит

GET/v1/api/api-usage/stats

API Usage Stats

Стежте за використанням API та залишком квоти

Ключові концепції

Пагінація

Керуйте наборами результатів за допомогою параметрів limit та offset.

  • limit — до 200 результатів на запит (за замовчуванням 30)
  • offset — пропустити N результатів
  • nextOffset — повертається, коли є ще результати

Фільтрація

Використовуйте типізовані префікси для точної фільтрації даних.

  • eq., contains., contains-i. — текстові фільтри
  • gt., gte., lt., lte. — порівняння діапазонів
  • Повторіть фільтр (до 2×) для діапазонів AND

Ліміти та заголовки

Обмеження token-bucket, що допускає короткі сплески, з чіткими HTTP-заголовками.

  • 300 запитів на годину на клієнта
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • 429 + Retry-After у разі перевищення

Пакетний запис

Записуйте малими, передбачуваними пакетами — елементи обробляються незалежно.

  • POST /records — до 20 елементів
  • PATCH — до 10 елементів
  • DELETE — до 10 ID

Варто знати

Конвертація валют

REST API автоматично використовує історичні курси валют для міжвалютних операцій. Конвертація працює за принципом best-effort — курси беруться з публічних ринкових даних і можуть трохи відрізнятися від банківських чи обмінних.

Підсумки та сортування

withTotal=true повертає загальну кількість збігів разом зі сторінкою; sortBy сортує за будь-яким підтримуваним полем (+ за зростанням, - за спаданням).

Стан синхронізації

Перший API-токен запускає початкову синхронізацію (запити повертають 409, доки вона не завершиться). Далі заголовки X-Last-Data-Change-At і X-Sync-In-Progress показують, наскільки свіжі дані.

Частковий успіх (HTTP 207)

Елементи пакета обробляються незалежно — змішані результати повертають підсумок за кожним елементом. Додайте validation=strict, щоб натомість швидко відхилити запит.

Приклади інтеграції

curl

Найпростіший спосіб протестувати API з терміналу.

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

Excel через Power Query

Імпортуйте транзакції безпосередньо в Excel для аналізу та звітів.

  1. 1.Відкрийте Excel → Дані → Отримати дані → З інтернету
  2. 2.Введіть: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Додайте заголовок Authorization з вашим Bearer токеном
  4. 4.Трансформуйте та завантажте дані в таблицю

Power BI Dashboard

Створюйте фінансові дашборди в реальному часі з автоматичним оновленням даних.

  1. 1.Використовуйте Web-конектор у Power BI Desktop
  2. 2.URL: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Налаштуйте автентифікацію Bearer token
  4. 4.Налаштуйте заплановане оновлення та створіть візуалізації

Аналіз на Python

Аналізуйте фінансові дані програмно за допомогою 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']}")

Готові почати?

Ознайомтеся з повною довідкою API з інтерактивною документацією, прикладами запитів та схемами відповідей.

Інтерактивний API-оглядачСпробувати інтеграцію MCP