---
id: breez-sdk-spark
version: "0.22.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# breez-sdk-spark — Python language bindings for the Breez Spark SDK

License: permissive · Maintenance: active · Downloads: 114.7K/mo

## What it is and what it does

Breez SDK - Spark is a Python wrapper around Breez's Rust-based Bitcoin and stablecoin payment SDK, designed to let developers add non-custodial payment flows to their applications without running a full node. It abstracts away the complexity of Bitcoin, Lightning, and Spark (a Layer 2 protocol built on multi-signature delegation) so that users can send and receive payments in BTC, USDT, USDC, and Spark tokens via Lightning addresses, LNURL-Pay, on-chain addresses, and Spark addresses.

The SDK handles key management (keys stay with the user), multi-device sync, payment persistence, and automatic on-chain claims. Under the hood, Spark uses a shared signing protocol where Spark Operators facilitate instant settlement without requiring blockchain confirmations, while funds remain non-custodial and can be exited to the Bitcoin main chain at any time. You'll need a free API key from Breez to initialize the SDK.

Use it for:

- Add Bitcoin/Lightning payment acceptance to a Python web app or service without managing your own node infrastructure.
- Build a mobile or desktop wallet that supports multiple payment protocols (Lightning, on-chain, Spark tokens) with a single SDK.
- Implement stablecoin (USDT/USDC) send functionality in a fintech or remittance application.
- Enable seedless, passkey-based login for a Bitcoin app with real-time balance sync across devices.
- Integrate Spark token issuance and transfer for custom tokenized value on a Bitcoin Layer 2.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python bindings for the Breez Spark SDK, enabling non-custodial Bitcoin and stablecoin payments via Lightning, Spark, and on-chain protocols.

Yes—if you are building a Bitcoin or stablecoin payment feature in Python and want to avoid the operational burden of running a Lightning node or managing keys yourself. The SDK is free, actively maintained, has no runtime dependencies, and covers a broad range of payment protocols. The main gotcha is the required API key; beyond that, install friction is low and security posture is solid (no vulnerabilities reported, MIT license, recent release).

## Install

pip install breez-sdk-spark
uv add breez-sdk-spark
poetry add breez-sdk-spark

## Installing breez-sdk-spark

Before you install: Medium install friction: precompiled wheels available across macOS, Linux (x86_64, aarch64), and Windows. Package is actively maintained with a recent release and no runtime dependencies to manage.

License in practice: MIT license (permissive) places no restrictions on commercial or private use; you may modify and distribute freely with attribution.

Quickstart:

pip install breez-sdk-spark

from breez_sdk_spark import BreezSDK

# Initialize SDK with API key (required from breez.technology)
sdk = BreezSDK(api_key='your_api_key')

Requires a free API key obtained from breez.technology; without it, SDK initialization will fail.

Verify before relying:

- Exact Python version support (requires_python field is unspecified in metadata)
- Whether passkey login and multi-device sync work out-of-the-box or require additional backend setup
- Real-world latency and fee characteristics for Spark vs. Lightning vs. on-chain payments
- Availability and stability of Spark Operators that facilitate the shared signing protocol

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: medium
- Maintenance: active
- Downloads: 114.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bitcoin lightning payments python, non-custodial crypto sdk, spark protocol integration, stablecoin payment sdk, breez sdk python bindings, self-custodial wallet integration, layer 2 bitcoin payments, bitcoin-payments, lightning-network, non-custodial

[View on SkillFed](https://skillfed.io/packages/breez-sdk-spark) · [View on PyPI](https://pypi.org/project/breez-sdk-spark/)