AtlatestRenderedmarkdown
Readme

sigil-wise

A Sigil library for the Wise (formerly TransferWise) API. Pull transactions, query balances, and manage profiles for personal finance automation.

Features

  • Profile management — list personal and business profiles
  • Balance queries — get current balances across all currencies
  • Transaction statements — pull detailed transaction history with automatic date windowing (handles Wise's 469-day limit transparently)
  • Multi-currency — works across all Wise-supported currencies
  • Error handling — SCA (PSD2) detection for UK/EEA accounts, rate limit handling
  • Sandbox support — configurable base URL for development against Wise sandbox

Usage

(import (wise))

;; Create a client with your personal API token
(define client (wise-client token: "your-api-token"))

;; List profiles
(define profiles (wise-profiles client))

;; Get balances for a profile
(define balances (wise-balances client (wise-profile-id (car profiles))))

;; Pull transactions for a date range
(define txns (wise-transactions client
               (wise-profile-id (car profiles))
               "2026-01-01T00:00:00Z"
               "2026-03-25T23:59:59Z"))

Configuration

Authentication uses a Wise personal API token:

  1. Log into Wise, go to Settings > API tokens
  2. Enable 2FA if not already active
  3. Generate a new token

Set WISE_API_TOKEN in your environment or pass it directly to wise-client.

For sandbox development, pass the sandbox URL:

(define client (wise-client token: "your-api-token"
                            base-url: "https://api.wise-sandbox.com"))

Dependencies

  • sigil-stdlib
  • sigil-http
  • sigil-json

Building

sigil deps install
sigil build
sigil test

License

BSD-3-Clause