Maker API Compatibility - KaleidoSwap Documentation

Compatibility

The SDK tracks the latest Maker API release: there is no version pairing to manage on this side. Keep both up to date to stay on supported endpoints and get new features as they ship.

To check the current Maker API version and updates, refer to the Maker API changelog or your API documentation.

API Endpoint Groups

The Maker API provides the following endpoint groups:

Endpoint Group	Base Path	Description
Market	`/api/v1/market/`	Asset listings, trading pairs, quote requests
Swaps (Atomic)	`/api/v1/swaps/`	HTLC-based atomic swap initialization, execution, and status tracking
LSPS1	`/api/v1/lsps1/`	Channel ordering, fee estimates, liquidity provisioning, and Lightning channel setup

The order-based swap endpoints (/api/v1/swaps/orders/*) were retired, and the matching SDK methods were removed in 0.1.13. Use the atomic swap flow instead — see How to Swap.

Using the Maker API

To use Maker API features with the SDK:

import { KaleidoClient, Layer } from 'kaleido-sdk';

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

// Access Maker API through client.maker
const assets = await client.maker.listAssets();
const pairs = await client.maker.listPairs();
const quote = await client.maker.getQuote({
  from_asset: { asset_id: 'BTC', layer: Layer.BTC_LN, amount: 100000 },
  to_asset: { asset_id: 'USDT', layer: Layer.RGB_LN },
});

import asyncio
from kaleido_sdk import KaleidoClient, Layer, PairQuoteRequest, SwapLegInput

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

    # Access Maker API through client.maker
    assets = await client.maker.list_assets()
    pairs = await client.maker.list_pairs()
    quote = await client.maker.get_quote(
        PairQuoteRequest(
            from_asset=SwapLegInput(asset_id="BTC", layer=Layer.BTC_LN, amount=100000),
            to_asset=SwapLegInput(asset_id="USDT", layer=Layer.RGB_LN),
        )
    )

asyncio.run(main())