ARC20

Build the PSBT for adding liquidity

post

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

/brc20swap/v2/create_add_liquid_psbt2

Body

application/json

tick1stringRequired

tick2stringRequired

amount_1stringRequired

amount_2stringRequired

slipperstringRequired

payer_ord_addrstringRequired

fee_ratestringRequired

payer_btc_addrstringRequired

payer_pub_keystringRequired

coin_type_1stringRequired

coin_type_2stringRequired

tokenstringRequired

Responses

200Success

application/json

x-200:Success

application/json

post

/brc20swap/v2/create_add_liquid_psbt2

HTTPcURLJavaScriptPython

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

{
  "tick1": "SHE•SHE•SHE•SHE•SHE",
  "coin_type_1": "runes",
  "amount_1": "1000",
  "tick2": "BTC",
  "coin_type_2": "btc",
  "amount_2": "1000",
  "fee_rate": "2",
  "slipper": "12",
  "token": "ee1f68b6bc00000:0",
  "payer_ord_addr": "tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e",
  "payer_btc_addr": "tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e",
  "payer_pub_key": "02d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee81:02d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee81"
}

{
  "code": 0,
  "msg": "",
  "data": {
    "ToSignInputs": [
      {
        "index": 0,
        "type": "btc"
      },
      {
        "index": 1,
        "type": "ord"
      }
    ],
    "psbt": "cHNidP8BAP2IAQIAAAAC/CDFTULM2Tq8fE0fFcmI2UC2NdYiIuIwJGuswCOfc+8IAAAAAP/////8IMVNQszZOrx8TR8VyYjZQLY11iIi4jAka6zAI59z7wAAAAAA/////wlKAQAAAAAAABYAFEZO83Wfz7HrPXbzMZ71jsIDAcZYSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJ0oBAAAAAAAAFgAUAYlgdU80lDqo/6jMzcVuGodfoSdKAQAAAAAAABYAFAGJYHVPNJQ6qP+ozM3FbhqHX6EnSgEAAAAAAAAWABQBiWB1TzSUOqj/qMzNxW4ah1+hJ0oBAAAAAAAAFgAUAYlgdU80lDqo/6jMzcVuGodfoScAAAAAAAAAAB9qXRwAspoEDcgBAQAAyAECAADIAQMAAMgBBAAAyAEF6AMAAAAAAAAiACBqchIOA610FalWEIeYYNG+heAwHPhDaaIoorsxPkb989wWAAAAAAAAFgAURk7zdZ/Pses9dvMxnvWOwgMBxlgAAAAAAAEBH7MkAAAAAAAAFgAURk7zdZ/Pses9dvMxnvWOwgMBxlgBAwQBAAAAAAEBH0oBAAAAAAAAFgAURk7zdZ/Pses9dvMxnvWOwgMBxlgBAwQBAAAAAAAAAAAAAAAAAA==",
    "check_sum": "74F36E9221834B276DBE1DFFD6AAA054",
    "tx_size": 407,
    "usr_cnt": 0,
    "vins": null,
    "check_sign_only": false
  },
  "req_id": "1887756069332492288"
}

Important Notes

1. Use the same address for both payer_ord_addr and payer_btc_addr.

2. Minimum injection thresholds:

   • BTC: 0.003

   • ARC20: ≥ 546 and must be a positive integer

3. After adding liquidity, the remaining balance of the token in the user's wallet must be either 0 or greater than 546.

Add liquidity

post

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

/brc20swap/v2/add_liquid_by_psbt

Body

application/json

psbtstringRequired

tick1stringRequired

tick2stringRequired

amount_1stringRequired

amount_2stringRequired

slipperstringRequired

payer_ord_addrstringRequired

fee_ratestringRequired

payer_btc_addrstringRequired

payer_pub_keystringRequired

check_sumstringOptional

chlstringOptional

coin_type_1stringRequired

coin_type_2stringRequired

tokenstringRequired

Responses

200Success

application/json

x-200:Success

application/json

post

/brc20swap/v2/add_liquid_by_psbt

HTTPcURLJavaScriptPython

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

{
  "tick1": "SHE•SHE•SHE•SHE•SHE",
  "coin_type_1": "runes",
  "amount_1": "1000",
  "tick2": "BTC",
  "coin_type_2": "btc",
  "amount_2": "1000",
  "fee_rate": "2",
  "slipper": "12",
  "token": "ee1f8f9acc00000:0",
  "payer_ord_addr": "tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e",
  "payer_btc_addr": "tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e",
  "payer_pub_key": "02d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee81:02d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee81",
  "psbt": "70736274ff0100fd88010200000002fc20c54d42ccd93abc7c4d1f15c988d940b635d62222e230246bacc0239f73ef0800000000fffffffffc20c54d42ccd93abc7c4d1f15c988d940b635d62222e230246bacc0239f73ef0000000000ffffffff094a01000000000000160014464ef3759fcfb1eb3d76f3319ef58ec20301c6584a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa1274a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa1274a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa1274a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa1274a01000000000000160014018960754f34943aa8ffa8cccdc56e1a875fa12700000000000000001f6a5d1c00b29a040dc801010000c801020000c801030000c801040000c80105e8030000000000002200206a72120e03ad7415a95610879860d1be85e0301cf84369a228a2bb313e46fdf3dc16000000000000160014464ef3759fcfb1eb3d76f3319ef58ec20301c658000000000001011fb324000000000000160014464ef3759fcfb1eb3d76f3319ef58ec20301c65801086c02483045022100bf5297dd65decb812cff9d20f3ea912f40e63f23159f4a86ddf7b5e644e5cfb102201474cb363601e373459d89ea12534c8aacb730d9ca43b0a703667b789e313b94012102d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee810001011f4a01000000000000160014464ef3759fcfb1eb3d76f3319ef58ec20301c65801086b0247304402206a76f519f02f52f16ccd71f6d94f7dd8a639a82609aadc9845f301004300cbe302203d244b00effd66f7c081a2510a1a79ab8efdc6b8463fc97f2997e692f2aeef75012102d3ac7452920b1cc4653516dd4f4381a2df0a8c0aac6e3446e633a73ea63eee8100000000000000000000",
  "check_sum": "74F36E9221834B276DBE1DFFD6AAA054"
}

{
  "code": 0,
  "msg": "",
  "data": {
    "order_id": "liquid_1072411956272431104"
  },
  "req_id": "1887758755461242880"
}

Finally, send the signed PSBT. If the response indicates success, the liquidity has been added/created successfully.