Wallet (By Budgetbakers)

Interact with the BudgetBakers Wallet API for personal finance data. Use when the user needs to query accounts, categories, transactions (records), budgets, or templates from their Wallet app via the REST API. Requires WALLET_API_TOKEN environment variable.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install wallet-api

Wallet API Skill

Interact with the BudgetBakers Wallet personal finance API.

Prerequisites

Premium Wallet plan required for API access
API Token from web.budgetbakers.com/settings/apiTokens
Set WALLET_API_TOKEN environment variable

Quick Start

export WALLET_API_TOKEN="your_token_here"
./scripts/wallet-api.sh me

API Reference

See references/api-reference.md for:

Authentication details
Rate limiting (500 req/hour)
Query filter syntax (text and range filters)
Pagination parameters
Data synchronization behavior
Agent hints

Available Commands

Command	Description
`me`	Current user info
`accounts`	List accounts
`categories`	List categories
`records`	List transactions
`budgets`	List budgets
`templates`	List templates

Query Parameters

All list endpoints support:

limit (default 30, max 100)
offset (default 0)

Filter Examples

Recent transactions:

./wallet-api.sh records "recordDate=gte.2025-02-01&limit=50"

Amount range:

./wallet-api.sh records "amount=gte.100&amount=lte.500"

Text search:

./wallet-api.sh records "note=contains-i.grocery"

Category + date:

./wallet-api.sh records "categoryId=eq.<id>&recordDate=gte.2025-01-01"

Filter Prefixes

Prefix	Meaning
`eq.`	Exact match
`contains.`	Contains (case-sensitive)
`contains-i.`	Contains (case-insensitive)
`gt.`	Greater than
`gte.`	Greater than or equal
`lt.`	Less than
`lte.`	Less than or equal

Common Workflows

Get Account Balances

./wallet-api.sh accounts

List Categories for Organization

./wallet-api.sh categories

Recent Spending

./wallet-api.sh records "recordDate=gte.2025-02-01&limit=100"

Filter by Payee

./wallet-api.sh records "payee=contains-i.amazon"

Data Sync Considerations

Initial sync returns 409 Conflict — wait and retry
Recent app changes may not appear immediately
Check X-Last-Data-Change-At header for freshness

Rate Limit Handling

Watch for:

429 Too Many Requests when exceeding 500/hour
X-RateLimit-Remaining header
Add agentHints=true for rate limit warnings