Skip to main content

​
Overview

Rate integrates with the Kaleidoswap maker API to let you swap between BTC and RGB assets without leaving the extension. The swap feature requires a maker API connection (configured in Settings > Networks).

​
Prerequisites

Before swapping:
  1. Your node must be connected
  2. The maker API must be connected (see Getting Started)
  3. You must have a sufficient balance of the asset you want to swap from

​
Swap Flow

1

Open Swap

Click the Swap button on the dashboard action grid.
2

Select Assets

Choose the From and To assets:
  • From - The asset you want to trade (e.g., BTC)
  • To - The asset you want to receive (e.g., USDT)
3

Enter Amount

Enter the amount you want to swap. The extension fetches a real-time quote from the maker API showing:
  • Exchange rate
  • Output amount
  • Fees
4

Review

The swap preview screen shows:
  • From asset and amount
  • To asset and amount
  • Exchange rate
  • Fee breakdown
  • Total cost
5

Confirm

Click Confirm Swap to execute. The extension creates the swap order via the maker API.
6

Track Status

The swap status screen shows real-time progress:
  • Order creation
  • Payment processing
  • Swap execution
  • Completion
Logs are displayed for transparency.

​
Real-Time Quotes

When you enter an amount, Rate fetches a quote from the maker API:
Quote FieldDescription
RateExchange rate between the two assets
Output AmountHow much you will receive
FeeProtocol and network fees
ExpiryHow long the quote is valid
Quotes update in real time as you change the amount.

​
Swap Status

After confirming, the swap progresses through several stages:
StatusDescription
Creating OrderThe swap order is being created
Processing PaymentYour payment is being processed
ExecutingThe maker is processing the swap
CompletedThe swap is done and you have received the asset
FailedSomething went wrong — check the logs for details

​
Maker API Configuration

The maker API endpoint can be configured in Settings > Networks:
SettingDefault
Maker URLhttps://api.regtest.kaleidoswap.com
You can point this to a different maker API if available.
The maker connection is optional. Without it, all other wallet features (send, receive, balances) work normally. Only the swap feature requires a maker connection.

​
Tips

Make sure you have enough of the source asset to cover both the swap amount and any fees.
Quotes expire after a short period. Review and confirm promptly to avoid needing a new quote.
If a swap fails, the status screen shows detailed logs that can help diagnose the issue.