Runes

Get the unsigned PSBT for exchange

post

https://test-api-proxy.ddpurse.comhttps://api.dotswap.app

/brc20swap/get_swap_psbt2

Body

application/json

send_coin_typestringRequired

send_tickstringRequired

send_amountstringRequired

receive_coin_typestringRequired

receive_tickstringRequired

receive_amountstringRequired

addressstringRequired

slipperintegerRequired

fee_rateintegerRequired

user_public_keystringRequired

chlstringRequired

methodstringOptional

Non-cross-pool swap, cross-pool pools_swap, just pass 'pools_swap'

tokenstringRequired

btc_addressstringRequired

Responses

200Success

application/json

codeintegerRequired

msgstringRequired

req_idstringRequired

x-200:Success

application/json

post

/brc20swap/get_swap_psbt2

HTTPcURLJavaScriptPython

POST /brc20swap/get_swap_psbt2 HTTP/1.1
Host: test-api-proxy.ddpurse.com
Content-Type: application/json
Accept: */*
Content-Length: 483

{
  "receive_amount": "9074",
  "receive_coin_type": "runes",
  "receive_tick": "SHE•SHE•SHE•SHE•SHE",
  "send_amount": "100000",
  "send_coin_type": "btc",
  "send_tick": "BTC",
  "slipper": 9,
  "fee_rate": 2,
  "token": "ee1fbac24400000:0",
  "user_public_key": "02d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee81:02d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee81",
  "address": "tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e",
  "btc_address": "tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e"
}

{
  "code": 0,
  "msg": "",
  "data": {
    "order_id": "swap_1072414914196275200",
    "psbt": "cHNidP8BAP3kAQIAAAAGY7oaL8gccUMryZKGtrngwmB/X560uaP4UbuD75PQxlMBAAAAAP/////8IMVNQszZOrx8TR8VyYjZQLY11iIi4jAka6zAI59z7wUAAAAA//////wgxU1CzNk6vHxNHxXJiNlAtjXWIiLiMCRrrMAjn3PvAgAAAAD//////CDFTULM2Tq8fE0fFcmI2UC2NdYiIuIwJGuswCOfc+8BAAAAAP/////8IMVNQszZOrx8TR8VyYjZQLY11iIi4jAka6zAI59z7wQAAAAA//////wgxU1CzNk6vHxNHxXJiNlAtjXWIiLiMCRrrMAjn3PvAwAAAAD/////B0oBAAAAAAAAFgAUAYlgdU80lDqo/6jMzcVuGodfoSdKAQAAAAAAABYAFAGJYHVPNJQ6qP+ozM3FbhqHX6EnSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJ0oBAAAAAAAAFgAURk7zdZ/Pses9dvMxnvWOwgMBxlgAAAAAAAAAABVqXRIAspoEDfJGAwAAtAIBAAC0AgLIiwEAAAAAACJRIAYWGj9nocZ7GjlVDA5sFWhS8i6cm/xnqpUQEKJ83DJKRWw3AAAAAAAWABRGTvN1n8+x6z128zGe9Y7CAwHGWAAAAAAAAQEf0Ps4AAAAAAAWABRGTvN1n8+x6z128zGe9Y7CAwHGWAEDBAEAAAAAAQEfSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJwEDBAEAAAAAAQEfSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJwEDBAEAAAAAAQEfSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJwEDBAEAAAAAAQEfSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJwEDBAEAAAAAAQEfSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJwEDBAEAAAAAAAAAAAAAAA==",
    "check_sign_only": false
  },
  "req_id": "1887761713347338240"
}

Important Notes:

1. After obtaining the unsigned PSBT, the user must sign it within 30 seconds.

2. Use the same address for both btc_address and address.

3. For user_public_key, provide the parameter as public_key:public_key for a wallet with one address, or btc_public_key:ordi_public_key for a wallet with two addresses.

4. The token must be retrieved from the /swap-info endpoint and can only be used once.

Send the signed PSBT for exchange

post

https://test-api-proxy.ddpurse.comhttps://api.dotswap.app

/brc20swap/send_swap_psbt

Body

application/json

order_idstringRequired

psbtstringRequired

Responses

200Success

application/json

codeintegerRequired

msgstringRequired

x-200:Success

application/json

post

/brc20swap/send_swap_psbt

HTTPcURLJavaScriptPython

POST /brc20swap/send_swap_psbt HTTP/1.1
Host: test-api-proxy.ddpurse.com
Content-Type: application/json
Accept: */*
Content-Length: 1763

{
  "order_id": "swap_1072414914196275200",
  "psbt": "70736274ff0100fde401020000000663ba1a2fc81c71432bc99286b6b9e0c2607f5f9eb4b9a3f851bb83ef93d0c6530100000000fffffffffc20c54d42ccd93abc7c4d1f15c988d940b635d62222e230246bacc0239f73ef0500000000fffffffffc20c54d42ccd93abc7c4d1f15c988d940b635d62222e230246bacc0239f73ef0200000000fffffffffc20c54d42ccd93abc7c4d1f15c988d940b635d62222e230246bacc0239f73ef0100000000fffffffffc20c54d42ccd93abc7c4d1f15c988d940b635d62222e230246bacc0239f73ef0400000000fffffffffc20c54d42ccd93abc7c4d1f15c988d940b635d62222e230246bacc0239f73ef0300000000ffffffff074a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa1274a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa1274a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa1274a01000000000000160014464ef3759fcfb1eb3d76f3319ef58ec20301c6580000000000000000156a5d1200b29a040df246030000b402010000b40202c88b01000000000022512006161a3f67a1c67b1a39550c0e6c156852f22e9c9bfc67aa951010a27cdc324a456c370000000000160014464ef3759fcfb1eb3d76f3319ef58ec20301c658000000000001011fd0fb380000000000160014464ef3759fcfb1eb3d76f3319ef58ec20301c65801086b0247304402200fad011f732edb4c2cf77c079e3603adfe0ca9376a47475c5f348b5f3bee4dce02201506df6edce6a06096b8d9a120993a6be987b16216543ae00d98af03f9b8278f012102d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee810001011f4a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa127010304010000000001011f4a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa127010304010000000001011f4a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa127010304010000000001011f4a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa127010304010000000001011f4a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa127010304010000000000000000000000"
}

{
  "code": 0,
  "msg": "",
  "data": {
    "tx_id": "045c00db3b398896756077f344de8893861788e26b6c3ee6e650e21eb2569524"
  },
  "req_id": "1887761723174592512"
}

After sending the signed PSBT, a successful response indicates that the swap was successful.

Extending Signing Duration

If you are using a hardware wallet, the signing process might take longer. To help us identify it being a hardware wallet, you can add the following header to the API requests:

Wallet-Type: 'ledger' | 'software'

For example:

config.headers["Wallet-Type"] = "ledger"; // Setting it to 'ledger' will extend the signing time, please use 'software' by default

cURL Example

curl 'https://api.dotswap.app/brc20swap/send_swap_psbt' \
 -H 'Accept: application/json, text/plain, _/_' \
 -H 'Accept-Language: en' \
 -H 'Cache-Control: no-cache' \
 -H 'Connection: keep-alive' \
 -H 'Content-Type: application/json' \
 -H 'Pragma: no-cache' \
 -H 'Sec-Fetch-Dest: empty' \
 -H 'Sec-Fetch-Mode: cors' \
 -H 'Sec-Fetch-Site: cross-site' \
 -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36' \
 -H 'Wallet-Name: unisat' \
 -H 'Wallet-Type: software' \
 -H 'Wallet-Ver: 1.5.4' \
 -H 'sec-ch-ua: "Google Chrome";v="131", "Chromium";v="131", "Not_A Brand";v="24"' \
 -H 'sec-ch-ua-mobile:?0' \
 -H 'sec-ch-ua-platform: "macOS"' \
 --data-raw '{"order_id":"swap_1071645262503477248","psbt":"70736274ff0100f302000000020a405df30d988160e1c3d3f046e7526e75a2522102e3a6b8dfbdb2fafe38df650600000000ffffffff90295f92edbbabe2ecb25d6f4eba74c91a930ebed4d6d51aac59eaf461328a110000000000ffffffff044a01000000000000225120e3552a2c24a4238a7344f655f04ceb0d14f381fbd9a4b90278d88257125444214a010000000000002251201447eda7459a2ab79ef45fc9173885d84b9604a746f7d2062eef08612536fa3500000000000000000d6a5d0a00c0a23303968ebd0e01e803000000000000225120c01dcf308ab6e8e0791741beda33a700406a94621eb9a1ee22bc95f3ea7bc1e0000000000001012bd20b0000000000002251201447eda7459a2ab79ef45fc9173885d84b9604a746f7d2062eef08612536fa3501084301414da5d08b5d44a76e600e41fb765d9eabe97c11d5bdeb3f2e61141567ac18bcfe1758f833591b24589e818deaa199a597b115cec9d04099c7a9fd2063532676fc010001012b4a01000000000000225120e3552a2c24a4238a7344f655f04ceb0d14f381fbd9a4b90278d8825712544421010304010000000000000000"}'