Create a chain swap
curl --request POST \
--url https://maker.signet.kaleidoswap.com/v2/swap/chain \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"preimageHash": "<string>",
"refundPublicKey": "<string>",
"claimPublicKey": "<string>",
"from": "<string>",
"fromAmount": 1,
"pairHash": "<string>",
"pairId": "<string>",
"serverLockAmount": 1,
"to": "<string>",
"userAddress": "<string>",
"userLockAmount": 1,
"webhook": {
"url": "<string>",
"hashSwapId": true,
"status": [
"<string>"
]
}
}
'import requests
url = "https://maker.signet.kaleidoswap.com/v2/swap/chain"
payload = {
"preimageHash": "<string>",
"refundPublicKey": "<string>",
"claimPublicKey": "<string>",
"from": "<string>",
"fromAmount": 1,
"pairHash": "<string>",
"pairId": "<string>",
"serverLockAmount": 1,
"to": "<string>",
"userAddress": "<string>",
"userLockAmount": 1,
"webhook": {
"url": "<string>",
"hashSwapId": True,
"status": ["<string>"]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
preimageHash: '<string>',
refundPublicKey: '<string>',
claimPublicKey: '<string>',
from: '<string>',
fromAmount: 1,
pairHash: '<string>',
pairId: '<string>',
serverLockAmount: 1,
to: '<string>',
userAddress: '<string>',
userLockAmount: 1,
webhook: {url: '<string>', hashSwapId: true, status: ['<string>']}
})
};
fetch('https://maker.signet.kaleidoswap.com/v2/swap/chain', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://maker.signet.kaleidoswap.com/v2/swap/chain",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'preimageHash' => '<string>',
'refundPublicKey' => '<string>',
'claimPublicKey' => '<string>',
'from' => '<string>',
'fromAmount' => 1,
'pairHash' => '<string>',
'pairId' => '<string>',
'serverLockAmount' => 1,
'to' => '<string>',
'userAddress' => '<string>',
'userLockAmount' => 1,
'webhook' => [
'url' => '<string>',
'hashSwapId' => true,
'status' => [
'<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://maker.signet.kaleidoswap.com/v2/swap/chain"
payload := strings.NewReader("{\n \"preimageHash\": \"<string>\",\n \"refundPublicKey\": \"<string>\",\n \"claimPublicKey\": \"<string>\",\n \"from\": \"<string>\",\n \"fromAmount\": 1,\n \"pairHash\": \"<string>\",\n \"pairId\": \"<string>\",\n \"serverLockAmount\": 1,\n \"to\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userLockAmount\": 1,\n \"webhook\": {\n \"url\": \"<string>\",\n \"hashSwapId\": true,\n \"status\": [\n \"<string>\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://maker.signet.kaleidoswap.com/v2/swap/chain")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"preimageHash\": \"<string>\",\n \"refundPublicKey\": \"<string>\",\n \"claimPublicKey\": \"<string>\",\n \"from\": \"<string>\",\n \"fromAmount\": 1,\n \"pairHash\": \"<string>\",\n \"pairId\": \"<string>\",\n \"serverLockAmount\": 1,\n \"to\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userLockAmount\": 1,\n \"webhook\": {\n \"url\": \"<string>\",\n \"hashSwapId\": true,\n \"status\": [\n \"<string>\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://maker.signet.kaleidoswap.com/v2/swap/chain")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"preimageHash\": \"<string>\",\n \"refundPublicKey\": \"<string>\",\n \"claimPublicKey\": \"<string>\",\n \"from\": \"<string>\",\n \"fromAmount\": 1,\n \"pairHash\": \"<string>\",\n \"pairId\": \"<string>\",\n \"serverLockAmount\": 1,\n \"to\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userLockAmount\": 1,\n \"webhook\": {\n \"url\": \"<string>\",\n \"hashSwapId\": true,\n \"status\": [\n \"<string>\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"swapAuth": "<string>",
"address": "<string>",
"claimDetails": {
"amount": 1,
"lockupAddress": "<string>",
"serverPublicKey": "<string>",
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
},
"timeoutBlockHeight": 1,
"assetId": "<string>",
"blindingKey": "<string>",
"feeAssetId": "<string>"
},
"claimPublicKey": "<string>",
"expectedAmount": 1,
"lockupDetails": {
"amount": 1,
"lockupAddress": "<string>",
"serverPublicKey": "<string>",
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
},
"timeoutBlockHeight": 1,
"assetId": "<string>",
"blindingKey": "<string>",
"feeAssetId": "<string>"
},
"payoutAmount": 1,
"serverLockup": {
"address": "<string>",
"amount": 1,
"refundPublicKey": "<string>",
"timeoutBlockHeight": 1,
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
}
},
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
},
"timeoutBlockHeight": 1,
"userAddress": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}Chain swaps
Create a chain swap
On-chain → on-chain. Send your preimage hash, a claim public key, a refund public key, and one amount side (userLockAmount or serverLockAmount). The maker returns lockupDetails (where you lock) and claimDetails (where it locks for you). Verify both against your keys before funding. The response carries swapAuth, issued once.
POST
/
v2
/
swap
/
chain
Create a chain swap
curl --request POST \
--url https://maker.signet.kaleidoswap.com/v2/swap/chain \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"preimageHash": "<string>",
"refundPublicKey": "<string>",
"claimPublicKey": "<string>",
"from": "<string>",
"fromAmount": 1,
"pairHash": "<string>",
"pairId": "<string>",
"serverLockAmount": 1,
"to": "<string>",
"userAddress": "<string>",
"userLockAmount": 1,
"webhook": {
"url": "<string>",
"hashSwapId": true,
"status": [
"<string>"
]
}
}
'import requests
url = "https://maker.signet.kaleidoswap.com/v2/swap/chain"
payload = {
"preimageHash": "<string>",
"refundPublicKey": "<string>",
"claimPublicKey": "<string>",
"from": "<string>",
"fromAmount": 1,
"pairHash": "<string>",
"pairId": "<string>",
"serverLockAmount": 1,
"to": "<string>",
"userAddress": "<string>",
"userLockAmount": 1,
"webhook": {
"url": "<string>",
"hashSwapId": True,
"status": ["<string>"]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
preimageHash: '<string>',
refundPublicKey: '<string>',
claimPublicKey: '<string>',
from: '<string>',
fromAmount: 1,
pairHash: '<string>',
pairId: '<string>',
serverLockAmount: 1,
to: '<string>',
userAddress: '<string>',
userLockAmount: 1,
webhook: {url: '<string>', hashSwapId: true, status: ['<string>']}
})
};
fetch('https://maker.signet.kaleidoswap.com/v2/swap/chain', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://maker.signet.kaleidoswap.com/v2/swap/chain",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'preimageHash' => '<string>',
'refundPublicKey' => '<string>',
'claimPublicKey' => '<string>',
'from' => '<string>',
'fromAmount' => 1,
'pairHash' => '<string>',
'pairId' => '<string>',
'serverLockAmount' => 1,
'to' => '<string>',
'userAddress' => '<string>',
'userLockAmount' => 1,
'webhook' => [
'url' => '<string>',
'hashSwapId' => true,
'status' => [
'<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://maker.signet.kaleidoswap.com/v2/swap/chain"
payload := strings.NewReader("{\n \"preimageHash\": \"<string>\",\n \"refundPublicKey\": \"<string>\",\n \"claimPublicKey\": \"<string>\",\n \"from\": \"<string>\",\n \"fromAmount\": 1,\n \"pairHash\": \"<string>\",\n \"pairId\": \"<string>\",\n \"serverLockAmount\": 1,\n \"to\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userLockAmount\": 1,\n \"webhook\": {\n \"url\": \"<string>\",\n \"hashSwapId\": true,\n \"status\": [\n \"<string>\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://maker.signet.kaleidoswap.com/v2/swap/chain")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"preimageHash\": \"<string>\",\n \"refundPublicKey\": \"<string>\",\n \"claimPublicKey\": \"<string>\",\n \"from\": \"<string>\",\n \"fromAmount\": 1,\n \"pairHash\": \"<string>\",\n \"pairId\": \"<string>\",\n \"serverLockAmount\": 1,\n \"to\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userLockAmount\": 1,\n \"webhook\": {\n \"url\": \"<string>\",\n \"hashSwapId\": true,\n \"status\": [\n \"<string>\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://maker.signet.kaleidoswap.com/v2/swap/chain")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"preimageHash\": \"<string>\",\n \"refundPublicKey\": \"<string>\",\n \"claimPublicKey\": \"<string>\",\n \"from\": \"<string>\",\n \"fromAmount\": 1,\n \"pairHash\": \"<string>\",\n \"pairId\": \"<string>\",\n \"serverLockAmount\": 1,\n \"to\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userLockAmount\": 1,\n \"webhook\": {\n \"url\": \"<string>\",\n \"hashSwapId\": true,\n \"status\": [\n \"<string>\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"swapAuth": "<string>",
"address": "<string>",
"claimDetails": {
"amount": 1,
"lockupAddress": "<string>",
"serverPublicKey": "<string>",
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
},
"timeoutBlockHeight": 1,
"assetId": "<string>",
"blindingKey": "<string>",
"feeAssetId": "<string>"
},
"claimPublicKey": "<string>",
"expectedAmount": 1,
"lockupDetails": {
"amount": 1,
"lockupAddress": "<string>",
"serverPublicKey": "<string>",
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
},
"timeoutBlockHeight": 1,
"assetId": "<string>",
"blindingKey": "<string>",
"feeAssetId": "<string>"
},
"payoutAmount": 1,
"serverLockup": {
"address": "<string>",
"amount": 1,
"refundPublicKey": "<string>",
"timeoutBlockHeight": 1,
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
}
},
"swapTree": {
"claimLeaf": {
"output": "<string>",
"version": 1
},
"refundLeaf": {
"output": "<string>",
"version": 1
}
},
"timeoutBlockHeight": 1,
"userAddress": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}Authorizations
PartnerAuthOrgKey
Secret organization API key from the partner panel, for servers. Sent on swap creation as Authorization: Bearer <key> to attribute the swap to your organization. Optional; an invalid key is rejected. Never use it in client-side code.
Body
application/json
Body of POST /v2/swap/chain — Boltz-shaped, camelCase. Atomic routes return one HTLC description per side and do not require a
destination address at creation. The legacy plain-send route remains
address-driven for backward compatibility.
The taker's BOLT11-style payment hash — SHA256(preimage),
32 bytes hex. Goes into the BTC lockup's claim leaf; the maker
reveals the preimage at claim time.
Taker's 33-byte compressed refund pubkey (BTC side). The maker is the claim party on the BTC P2TR — taker refunds via script- path if the maker fails to claim.
Taker's 33-byte compressed claim pubkey for the Liquid side. Required for an atomic pair (the taker is the claim party on the maker's L-USDT HTLC); ignored for the plain-send pair.
Boltz: source on-chain currency symbol (e.g. "BTC").
Legacy alias for userLockAmount.
Required range:
x >= 0Optional pairHash rate-lock: the hash the taker quoted against. Verified against the pair's current rate card when present;
a mismatch is rejected with 400 pair_hash_mismatch.
Trading-pair key. Must resolve to a Chain pair in the engine —
Optional when from+to are given (stock Boltz SDK shape).
Desired output-side amount; the maker inverse-quotes the canonical input. Exactly one amount side is accepted.
Required range:
x >= 0Boltz: destination on-chain currency symbol (e.g. "L-USDT").
Legacy plain-send destination. Atomic swaps construct the payout from
claimDetails after creation and therefore do not require it.
Input-side amount. Exactly one of this and serverLockAmount is
required.
Required range:
x >= 0Optional HTTPS callback for status changes.
Show child attributes
Show child attributes
Response
Chain swap created.
POST /v2/swap/chain response. Atomic Liquid pairs use Boltz's standard
lockupDetails + claimDetails shape. The optional flat fields preserve
the existing plain-send and Arkade extension responses.
Per-swap taker credential, 32 bytes hex — see
swapAuth. Chain swaps also need it on
POST /v2/swap/chain/{id}/quote.
One side of the standard atomic Chain create response.
Show child attributes
Show child attributes
Required range:
x >= 0One side of the standard atomic Chain create response.
Show child attributes
Show child attributes
L-USDT amount the maker delivers once the BTC deposit confirms.
Required range:
x >= 0Present only for atomic chain pairs — the maker's L-USDT (or VHTLC) lockup the taker claims revealing the preimage.
Show child attributes
Show child attributes
swapTree returned on every swap creation + status response.
Show child attributes
Show child attributes
Required range:
x >= 0Was this page helpful?