Wallet (By Budgetbakers)

封装 BudgetBakers Wallet 的 REST API 访问：借助 shell 脚本与 curl 查询账户、分类、交易记录、预算和模板，支持 limit/offset 分页以及 eq./contains-i./gte. 等过滤前缀，需配置 WALLET_API_TOKEN，并提示 409 同步冲突与 429 限流处理。

andresubri

热度 64.52

最近更新 2026-05-11 17:25:56

分类：生活依赖：代码执行 / 第三方 API应用场景：个人理财 / 财务 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add wallet-api

Metadata

name: wallet-api
description: 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.

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