How do I install the Wallet API skill?

Run npx skillmds@latest add knownasnaffy/wallet-api-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Wallet API safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wallet API?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Wallet API free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Wallet API?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wallet API by knownasnaffy — Agent Skill

Name: Wallet API
Rating: 4.666666666666667 (3 reviews)
Author: knownasnaffy

Wallet API

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.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Cleanup Review

python scripts/_cleanup.py is an optional cleanup helper for the Wallet API Skill skill. It may recursively remove /tmp/.skill_state, /tmp/skill_cache. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.

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

---name: wallet-api-2description: 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.---### Cleanup Review`python scripts/_cleanup.py` is an optional cleanup helper for the `Wallet API Skill` skill. It may recursively remove /tmp/.skill_state, /tmp/skill_cache. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.# Wallet API SkillInteract with the BudgetBakers Wallet personal finance API.## Prerequisites1. **Premium Wallet plan** required for API access2. **API Token** from [web.budgetbakers.com/settings/apiTokens](https://web.budgetbakers.com/settings/apiTokens)3. Set `WALLET_API_TOKEN` environment variable## Quick Start```bashexport WALLET_API_TOKEN="your_token_here"./scripts/wallet-api.sh me```## API ReferenceSee [references/api-reference.md](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 ParametersAll list endpoints support:- `limit` (default 30, max 100)- `offset` (default 0)### Filter Examples**Recent transactions:**```bash./wallet-api.sh records "recordDate=gte.2025-02-01&limit=50"```**Amount range:**```bash./wallet-api.sh records "amount=gte.100&amount=lte.500"```**Text search:**```bash./wallet-api.sh records "note=contains-i.grocery"```**Category + date:**```bash./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```bash./wallet-api.sh accounts```### List Categories for Organization```bash./wallet-api.sh categories```### Recent Spending```bash./wallet-api.sh records "recordDate=gte.2025-02-01&limit=100"```### Filter by Payee```bash./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 HandlingWatch for:- `429 Too Many Requests` when exceeding 500/hour- `X-RateLimit-Remaining` header- Add `agentHints=true` for rate limit warnings

Frequently asked questions