AtlatestRepositorysigil-wise

sigil-wise / treeREADME.md

Read it rendered

1# sigil-wise
2
3A Sigil library for the [Wise](https://wise.com) (formerly TransferWise) API. Pull transactions, query balances, and manage profiles for personal finance automation.
4
5## Features
6
7- **Profile management** — list personal and business profiles
8- **Balance queries** — get current balances across all currencies
9- **Transaction statements** — pull detailed transaction history with automatic date windowing (handles Wise's 469-day limit transparently)
10- **Multi-currency** — works across all Wise-supported currencies
11- **Error handling** — SCA (PSD2) detection for UK/EEA accounts, rate limit handling
12- **Sandbox support** — configurable base URL for development against Wise sandbox
14## Usage
16```scheme
17(import (wise))
19;; Create a client with your personal API token
20(define client (wise-client token: "your-api-token"))
22;; List profiles
23(define profiles (wise-profiles client))
25;; Get balances for a profile
26(define balances (wise-balances client (wise-profile-id (car profiles))))
28;; Pull transactions for a date range
29(define txns (wise-transactions client
30 (wise-profile-id (car profiles))
31 "2026-01-01T00:00:00Z"
32 "2026-03-25T23:59:59Z"))
33```
35## Configuration
37Authentication uses a Wise personal API token:
391. Log into Wise, go to Settings > API tokens
402. Enable 2FA if not already active
413. Generate a new token
43Set `WISE_API_TOKEN` in your environment or pass it directly to `wise-client`.
45For sandbox development, pass the sandbox URL:
46```scheme
47(define client (wise-client token: "your-api-token"
48 base-url: "https://api.wise-sandbox.com"))
49```
51## Dependencies
53- sigil-stdlib
54- sigil-http
55- sigil-json
57## Building
59```
60sigil deps install
61sigil build
62sigil test
63```
65## License
67BSD-3-Clause