KaleidoSwap: Bitcoin DEX on Lightning

Abstract KaleidoSwap emblem: a faceted purple and green gem mark surrounded by lightning bolts and coin icons over a dark circuit-board background

KaleidoSwap is building the liquidity layer for Bitcoin-native atomic swaps, enabling anyone to exchange Bitcoin-based assets freely, privately, and without intermediaries. Its vertically integrated stack spans end-user applications such as the Desktop App and the Browser Extension, a multi-language SDK, AI tools for autonomous AI agents and local AI brains, and market-maker software.

Why KaleidoSwap?

Multi-Protocol

Hold, spend, and swap assets across all Bitcoin Layers with instant atomic settlement

Non-Custodial

Your keys, your coins. No accounts, no intermediaries. Just connect your wallet or run your own node

Open Source

Fully open source with MIT license. Inspect the code, contribute, or build your own integration

Multi-Platform

Desktop App available for macOS, Windows, and Linux. Extension available in the browser

Platform Overview

KaleidoSwap platform diagram: Desktop, Extension, Mobile, and Web App clients connecting through the swap-sdk and wallet-sdk integration layer to Bitcoin, Lightning, and Layer 2 protocol icons, the KaleidoSwap LSP and market makers, and the KaleidoMind and KaleidoAgent intelligence layer

The stack is vertically integrated: a single SDK powers every client we ship and every third-party integration, so each surface talks to the same swap engine, the same protocols, and the same liquidity.

Clients & integrators — Desktop, Extension, Mobile, and Web App, alongside third-party wallets, neobanks, payment processors, and AI agents building on the same interfaces.
Integration layer — swap-sdk for swap integration (TypeScript, Python, Rust) and wallet-sdk for wallet primitives (TypeScript). Start with the SDK →
Protocols — Bitcoin on-chain and Lightning, plus the Bitcoin Layer protocols swaps can settle on. How it works →
Liquidity layer — the KaleidoSwap LSP bootstraps liquidity today; external market makers join from 2027.
Intelligence layer — KaleidoMind, the self-hosted AI brain (QVAC runtime, Skills and MCP libraries, fine-tuned models), and KaleidoAgent, an autonomous trading agent that runs against a local model or Claude and OpenAI. Explore AI Tools →

Components marked LIVE are in production today; the rest are on the 2026 roadmap.

For Traders

Trade from your own wallet with our apps and extensions:

Getting Started

Install the app

Download for macOS, Windows, or Linux. Installation Guide →

Create a wallet

Generate a new wallet and save your recovery phrase. Wallet Setup →

Deposit & open channels

Fund your wallet and open Lightning channels. Deposit Guide → · Channel Guide →

Start trading

Execute atomic swaps with RGB assets. Trading Guide →

Guides

Desktop Guide

Nodes, wallets, channels, and trading

Extensions

Multi-layer wallet, swaps, and DApp connectivity

AI Tools

Autonomous agent for portfolio management and local-AI brain

For Builders

Build on KaleidoSwap with our SDKs, APIs, and AI Tools:

Getting Started

Install the SDK

npm install kaleido-sdk for TypeScript, pip install kaleido-sdk for Python. Installation Guide →

Create a client

Point KaleidoClient.create() at a regtest, signet, or mainnet endpoint. Client Reference →

Request a quote

Fetch trading pairs and live quotes from the maker. Market APIs →

Execute a swap

Run your first non-custodial atomic swap end to end. How to Swap →

import { KaleidoClient } from 'kaleido-sdk';

const client = KaleidoClient.create({
  baseUrl: 'https://api.signet.kaleidoswap.com'
});

// Get available trading pairs
const pairs = await client.maker.listPairs();

// Get a quote
const quote = await client.maker.getQuote({
  from_asset: { asset_id: 'BTC', layer: 'BTC_LN', amount: 100000 },
  to_asset: { asset_id: 'USDT', layer: 'RGB_LN' }
});

from kaleido_sdk import KaleidoClient

client = KaleidoClient.create(
    base_url="https://api.signet.kaleidoswap.com"
)

# Get available trading pairs
pairs = client.maker.list_pairs()

# Get a quote
quote = client.maker.get_quote({
    "from_asset": {"asset_id": "BTC", "layer": "BTC_LN", "amount": 100000},
    "to_asset": {"asset_id": "USDT", "layer": "RGB_LN"}
})

Guides

SDK

Full SDK reference, examples, and best practices

API Reference

REST endpoints and swap protocol details

CLI

Run local nodes, swaps, and channel flows from the terminal

AI Tools

MCP servers for wallet operations and Skills files for specific behaviors

Community & Support

Join our community chat

Twitter/X

GitHub

Contribute to the project

KaleidoSwap is open source software licensed under the MIT License.

Introduction

System Design

Reference

Why KaleidoSwap?

Multi-Protocol

Non-Custodial

Open Source

Multi-Platform

Platform Overview

For Traders

Getting Started

Guides

Desktop Guide

Extensions

AI Tools

For Builders

Getting Started

Guides

SDK

API Reference

CLI

AI Tools

Community & Support

Telegram

Twitter/X

GitHub

​Why KaleidoSwap?

Multi-Protocol

Non-Custodial

Open Source

Multi-Platform

​Platform Overview

​For Traders

​Getting Started

​Guides

Desktop Guide

Extensions

AI Tools

​For Builders

​Getting Started

​Guides

SDK

API Reference

CLI

AI Tools

​Community & Support

Telegram

Twitter/X

GitHub

Why KaleidoSwap?

Platform Overview

For Traders

Getting Started

Guides

For Builders

Getting Started

Guides

Community & Support