Wise Python SDK

Typed synchronous and asynchronous clients for the Wise Platform API. Python 3.11+, HTTPX and Pydantic. Community maintained and not affiliated with Wise.

pip install wise-sdk

Quick start

Set WISE_ACCESS_TOKEN to a sandbox API token in your server environment.

from wise_sdk import WiseClient, WiseEnvironment

with WiseClient(environment=WiseEnvironment.SANDBOX) as client:
    profiles = client.profiles.list()
    if not profiles or profiles[0].id is None:
        raise ValueError("No profile available")
    balances = client.balances.list(profile_id=profiles[0].id, types="STANDARD")
    print([(balance.currency, balance.amount) for balance in balances])

Choose your intended profile when several exist. Select WiseEnvironment.PRODUCTION with separate production credentials for live requests.

Async client

import asyncio
from wise_sdk import AsyncWiseClient

async def main():
    async with AsyncWiseClient() as client:
        profiles = await client.profiles.list()
        print(f"Found {len(profiles)} profiles")

asyncio.run(main())

Use context managers or close() / await aclose() to release owned connections. A supplied httpx_client remains owned by your application.

Client options

Use request_options for per-call headers, query parameters and timeout settings. client.<resource>.with_raw_response provides HTTP metadata. HTTP failures raise ApiError; inspect status_code, body and headers without logging sensitive data.

Helpers and models

Generated Pydantic models are exported from wise_sdk. Python integer IDs retain their precision. Date-time request parameters use timezone-aware datetime values. Wise amounts use major currency units; use decimal arithmetic for calculations.

• WiseOAuth / AsyncWiseOAuth expose four OAuth grants and authorization URL helpers.
• TokenManager / AsyncTokenManager coordinate token acquisition and persistence within one instance.
• create_mtls_context() loads a client certificate into a verified SSL context.
• iter_recipients(), iter_activities() and iter_transfers() fetch lazily; async variants start with async_iter_.
• verify_webhook_signature() verifies raw webhook bytes; install pip install 'wise-sdk[webhooks]' to use it.
• get_sca_challenge() detects documented SCA approval headers.

Documentation

Authentication · Endpoint map · API details · Webhooks · Release notes

Generated from the official 2026Q3 specification with Fern. Account permissions, regional restrictions and partner onboarding determine which endpoints you can use.