Interact with Up Bank (api.up.com.au) to retrieve account balances, transactions, and financial data in real-time. Use when the user asks about their Up bank account, balance, spending, transactions, or wants to check their finances. Triggers on: 'Up bank', 'my balance', 'check transactions', 'what did I spend', 'recent transactions', 'Up account'.
Real-time access to your Up Bank account via the API.
up:yeah:)Store the token securely in 1Password:
op item create --vault "Your Vault" \
--title "Up Bank API Token" \
--category password \
password="up:yeah:your-token-here"
Note the item ID for retrieval, e.g.:
op://vault-id/item-id/password
The token is read from the UP_API_TOKEN environment variable:
# From 1Password
export UP_API_TOKEN=$(op read 'op://vault-id/item-id/password')
# Run commands
~/.agents/skills/up-bank/scripts/up-cli.ts ping
~/.agents/skills/up-bank/scripts/up-cli.ts balance
~/.agents/skills/up-bank/scripts/up-cli.ts transactions --limit 20
| Command | Description |
|---|---|
ping | Test API connection |
balance | Show total balance across all accounts |
accounts | List all accounts with details |
account <id> | Get specific account details |
transactions | List recent transactions |
categories | List spending categories |
tags | List transaction tags |
--json - Output as JSON for parsing--limit <n> - Limit number of results (default: 10)--account <id> - Filter transactions by account--since <date> - Transactions since ISO date--until <date> - Transactions until ISO date--status <HELD|SETTLED> - Filter by transaction statusUP_API_TOKEN=$(op read 'op://vault-id/item-id/password') \
~/.agents/skills/up-bank/scripts/up-cli.ts balance
UP_API_TOKEN=$(op read 'op://vault-id/item-id/password') \
~/.agents/skills/up-bank/scripts/up-cli.ts transactions --limit 20
UP_API_TOKEN=$(op read 'op://vault-id/item-id/password') \
~/.agents/skills/up-bank/scripts/up-cli.ts transactions --json --limit 50
UP_API_TOKEN=$(op read 'op://vault-id/item-id/password') \
~/.agents/skills/up-bank/scripts/up-cli.ts transactions --since 2024-01-01 --json | \
jq '[.[] | select(.attributes.amount.value | startswith("-"))] | .[].attributes.amount.value | tonumber | add'
See references/api.md for detailed API documentation including:
scripts/up-client.ts - API client libraryscripts/up-cli.ts - CLI interfacereferences/api.md - API documentation