commit 76c911a2f9f2c8a326b8dc2c4e675f8d88f3823c Author: Helios Agent Date: Mon Feb 23 01:25:03 2026 +0100 Initial commit for helios-splitwise diff --git a/README.md b/README.md new file mode 100644 index 0000000..48c8455 --- /dev/null +++ b/README.md @@ -0,0 +1,15 @@ +# Helios Splitwise Skill + +Access Moritz' Splitwise account via API. +View groups, balances, expenses and friends. + +## Setup + +Requires `SPLITWISE_API_KEY` in `~/.openclaw/secrets/splitwise.env`. + +## Features + +- View group balances +- List recent expenses +- Check pending payments +- (Limited) Create new expenses diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..e51d652 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,62 @@ +--- +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)