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.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "wallet-api" with this command: npx skills add andresubri/wallet-api

Wallet API Skill

Interact with the BudgetBakers Wallet personal finance API.

Prerequisites

  1. Premium Wallet plan required for API access
  2. API Token from web.budgetbakers.com/settings/apiTokens
  3. 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

CommandDescription
meCurrent user info
accountsList accounts
categoriesList categories
recordsList transactions
budgetsList budgets
templatesList 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

PrefixMeaning
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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Web3

Bitcoin and Tether on Arkade

Send and receive Bitcoin over Arkade (offchain), onchain (via onboard/offboard), and Lightning. Swap USDC/USDT stablecoins.

Registry SourceRecently Updated
1.4K3tiero
Web3

OK Computers + Ring Gates + Net Protocol

Interact with your OK Computer NFT on Base blockchain for onchain messaging, posting, DMs, username and website management via signed transactions.

Registry SourceRecently Updated
1.4K0potdealer
Web3

Xian SDK

Build applications on the Xian blockchain using the xian-py Python SDK. Use when developing apps that interact with Xian — wallets, transactions, smart contracts, state queries, token transfers. Covers sync and async patterns.

Registry SourceRecently Updated
1.1K0endogen
Web3

Github Copilot Cli

Efficient daily use of GitHub Copilot CLI for senior engineers. Use when planning, prompting, reviewing, or chaining Copilot CLI commands (gh copilot) to explore codebases, draft changes, debug issues, or accelerate workflows without losing architectural intent.

Registry SourceRecently Updated
1.8K10wilsonle