Market And Swaps

Market Data

The market group is the read-only entry point for pairs, quotes, routes, and maker metadata.

Command	Purpose
`kaleido market assets`	List tradeable assets
`kaleido market pairs`	List trading pairs
`kaleido market quote <pair>`	Request a quote
`kaleido market info`	Show maker node information
`kaleido market routes <pair>`	List route options

Quote examples

kaleido market quote BTC/USDT --from-amount 0.001
kaleido market quote BTC/USDT --to-amount 500 --from-layer BTC_LN --to-layer RGB_LN

Important quote options:

--from-amount or --to-amount
--from-layer
--to-layer

Supported layer values include BTC_LN, RGB_LN, and BTC_ONCHAIN for market quotes.

Swap Scopes

Swaps are split across two command groups:

Scope	Use case
`swap atomic`	Run maker-backed atomic swaps using your local node as taker
`node swap`	Drive low-level local RLN swap steps directly (under the `node` group)

Atomic Swap Flow

Use swap atomic when the maker side is remote but execution uses your local node as taker.

Subcommands

Command	Purpose
`kaleido swap atomic init <pair>`	Initialize the atomic swap
`kaleido swap atomic execute`	Execute the initialized swap (`--swapstring`, `--taker-pubkey`, `--payment-hash`, prompted if omitted; `--auto-whitelist`)
`kaleido swap atomic status <payment-hash>`	Track atomic swap status
`kaleido swap atomic run <pair>`	Run init, whitelist, and execute in one command

Example

kaleido swap atomic run BTC/USDT --to-amount 5

You can also provide:

--taker-pubkey
--yes
explicit --from-layer and --to-layer

Local Node Swap Flow

Use node swap for low-level RLN swap steps (these live under the node command group):

Command	Purpose
`kaleido node swap pubkey`	Print the taker public key
`kaleido node swap init`	Start a local maker-init swap flow (`--from-asset`, `--qty-from`, `--to-asset`, `--qty-to`, `--timeout`)
`kaleido node swap whitelist --swapstring '<swapstring>'`	Whitelist the swap on the taker side
`kaleido node swap execute`	Execute after whitelisting
`kaleido node swap status <payment-hash>`	Inspect status (`--taker` or `--maker`)
`kaleido node swap list`	List swaps known to the node

This path is useful for debugging, demos, and lower-level protocol operations where you want each step exposed separately.

Recommended Trade Flow

Browse the market (no node required)

kaleido market pairs
kaleido market quote BTC/USDT --from-amount 0.001

Executing a swap requires a local RLN node — use the atomic flow below.

With a local node

kaleido node unlock
kaleido node swap pubkey
kaleido swap atomic run BTC/USDT --from-amount 0.001 --from-layer BTC_LN --to-layer RGB_LN

Use Command Reference for the complete command map.

Introduction

Local Node Operations

Trading & Channels

Reference

Market Data

Quote examples

Swap Scopes

Atomic Swap Flow

Subcommands

Example

Local Node Swap Flow

Recommended Trade Flow

Browse the market (no node required)

With a local node

​Market Data

​Quote examples

​Swap Scopes

​Atomic Swap Flow

​Subcommands

​Example

​Local Node Swap Flow

​Recommended Trade Flow

​Browse the market (no node required)

​With a local node

Market Data

Quote examples

Swap Scopes

Atomic Swap Flow

Subcommands

Example

Local Node Swap Flow

Recommended Trade Flow

Browse the market (no node required)

With a local node