Skip to main content
POST
Initiate an atomic swap

Authorizations

Authorization
string
header
required

Pass a Kaleido API key such as kld_live_c_....

Body

application/json
rfq_id
string
required
Example:

"1234567890"

from_asset
string
required
Example:

"BTC"

from_amount
integer<int64>
required
Example:

1000000

to_asset
string
required
Example:

"rgb:2dkSTbr-jFhznbPmo-TQafzswCN-av4gTsJjX-ttx6CNou5-M98k8Zd"

to_amount
integer<int64>
required
Example:

1000000

Response

Swap initialized successfully.

swapstring
string
required
Example:

"30/rgb:2dkSTbr-jFhznbPmo-TQafzswCN-av4gTsJjX-ttx6CNou5-M98k8Zd/10/rgb:2eVw8uw-8G88LQ2tQ-kexM12SoD-nCX8DmQrw-yLMu6JDfK-xx1SCfc/1715896416/9d342c6ba006e24abee84a2e034a22d5e30c1f2599fb9c3574d46d3cde3d65a2"

payment_hash
string
required
Example:

"9d342c6ba006e24abee84a2e034a22d5e30c1f2599fb9c3574d46d3cde3d65a2"

access_token
string | null

Per-swap token required to poll /swaps/atomic/status. Returned only once here at initiation — store it alongside the payment hash.