Commit95933523Recorded25 Mar 2026Repositorysigil-wise
Add comprehensive README
Changed
README.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 65 insertions(+), 1 deletion(-)Diff
README.mdmodified
@@ -1,3 +1,67 @@
1
# sigil-wise 2
−3
Wise API client library for Sigil 3
No newline at end of file+4
A Sigil library for the [Wise](https://wise.com) (formerly TransferWise) API. Pull transactions, query balances, and manage profiles for personal finance automation.+5
+6
## Features+7
+8
- **Profile management** — list personal and business profiles+9
- **Balance queries** — get current balances across all currencies+10
- **Transaction statements** — pull detailed transaction history with automatic date windowing (handles Wise's 469-day limit transparently)+11
- **Multi-currency** — works across all Wise-supported currencies+12
- **Error handling** — SCA (PSD2) detection for UK/EEA accounts, rate limit handling+13
- **Sandbox support** — configurable base URL for development against Wise sandbox+14
+15
## Usage+16
+17
```scheme+18
(import (sigil wise))+19
+20
;; Create a client with your personal API token+21
(define client (make-wise-client "your-api-token"))+22
+23
;; List profiles+24
(define profiles (wise-profiles client))+25
+26
;; Get balances for a profile+27
(define balances (wise-balances client (wise-profile-id (car profiles))))+28
+29
;; Pull transactions for a date range+30
(define txns (wise-transactions client+31
(wise-profile-id (car profiles))+32
"2026-01-01T00:00:00Z"+33
"2026-03-25T23:59:59Z"))+34
```+35
+36
## Configuration+37
+38
Authentication uses a Wise personal API token:+39
+40
1. Log into Wise, go to Settings > API tokens+41
2. Enable 2FA if not already active+42
3. Generate a new token+43
+44
Set `WISE_API_TOKEN` in your environment or pass it directly to `make-wise-client`.+45
+46
For sandbox development, pass the sandbox URL:+47
```scheme+48
(define client (make-wise-client token base-url: "https://api.wise-sandbox.com"))+49
```+50
+51
## Dependencies+52
+53
- sigil-stdlib+54
- sigil-tls+55
- sigil-http+56
- sigil-json+57
- sigil-log+58
+59
## Building+60
+61
```+62
sigil build --redirects dev-redirects.sgl+63
sigil test+64
```+65
+66
## License+67
+68
BSD-3-Clause