Konto — Personal Finance API
Query personal finance data from Konto (bank accounts, investments, assets, loans, transactions).
Setup
# ~/.openclaw/secrets/konto.env
export KONTO_API_KEY="konto_xxxxxxxxxxxx"
export KONTO_URL="https://konto.angelstreet.io"
Quick Answers
"How much BTC do I have?"
source ~/.openclaw/secrets/konto.env
curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/investments" | jq '.investments[] | select(.code | test("BTC|bitcoin"; "i")) | {label, quantity, current_value}'
"What's my net worth?"
curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/summary" | jq '{patrimoine_net, accounts: .accounts.total_balance, investments: .investments.total_value, assets: .assets.total_value, loans: .loans.total_remaining}'
"When does my loan end?"
curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/loans" | jq '.loans[] | {name, remaining_amount, end_date, monthly_payment}'
"What are my subscriptions?"
curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/summary" | jq '{count: .subscriptions.count, monthly: .subscriptions.monthly}'
"How much do I spend on housing?"
curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/transactions?months=6&category=logement" | jq '{total: .total, transactions: [.transactions[] | {date, label, amount}]}'
"Financial overview"
curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/summary"
Helper Script
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh summary
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh investments
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh transactions 3 # last 3 months
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh loans
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh assets
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh accounts
Endpoints
| Endpoint | Description |
|---|---|
GET /api/v1/summary | Full financial overview (start here) |
GET /api/v1/accounts | Bank accounts list |
GET /api/v1/transactions?months=6&category=X | Categorized transactions |
GET /api/v1/investments | Portfolio (ETFs, stocks, crypto) |
GET /api/v1/assets | Real estate, vehicles |
GET /api/v1/loans | Active loans |
Full API Reference
See ~/shared/projects/konto/docs/api.md for complete docs including analytics endpoints.
Scope
This skill uses a personal scope key (free). For cross-user analytics (pro), see the konto-analytics skill.