helios-splitwise/SKILL.md

62 lines
1.7 KiB
Markdown

---
name: splitwise
description: Access Splitwise to check balances, expenses, and groups.
---
# Splitwise
Access Moritz' Splitwise account via API.
## Auth
API key in `~/.openclaw/secrets/splitwise.env`. Use as Bearer token.
## Base URL
`https://secure.splitwise.com/api/v3.0`
## Common Requests
### Current user
```bash
source ~/.openclaw/secrets/splitwise.env
curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_current_user"
```
### Groups (with balances)
```bash
curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_groups"
```
### Expenses (recent, paginated)
```bash
curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_expenses?limit=20&offset=0"
```
### Expenses for a group
```bash
curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_expenses?group_id=GROUP_ID&limit=20"
```
### Friends
```bash
curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_friends"
```
### Create expense (equal split between 2 users)
```bash
curl -s -X POST -H "Authorization: Bearer $SPLITWISE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"cost":"10.00","description":"Dinner","currency_code":"EUR","group_id":0,"users__0__user_id":71761923,"users__0__paid_share":"10.00","users__0__owed_share":"5.00","users__1__user_id":OTHER_USER_ID,"users__1__paid_share":"0","users__1__owed_share":"5.00"}' \
"https://secure.splitwise.com/api/v3.0/create_expense"
```
## IDs
- Moritz: 71761923
## Notes
- All amounts in EUR
- NIEMALS Ausgaben erstellen ohne Moritz' Zustimmung
- Rate limits apply (personal API)