Bitcoin Channel

Commit

Construct Bitcoin Channel commit PSBT

post

/brc20swap/create_deposit_psbt

Header parameters

CookiestringRequiredExample: <Cookie>

Content-TypestringRequiredExample: <Content-Type>

Body

coin_typestringRequired

tickstringRequired

valuestringRequired

payer_pub_keystringRequired

payer_btc_addrstringRequired

Reserved for xverse wallets; pass the same address twice if using unisat

payer_ord_addrstringRequired

fee_rateintegerRequired

inscription_idsstring[]Required

Convenient for constructing psbt

is_multi_sign_tradebooleanRequired

Responses

200

Success

application/json

post

/brc20swap/create_deposit_psbt

POST /brc20swap/create_deposit_psbt HTTP/1.1
Host: api.dotswap.app
Cookie: text
Content-Type: application/json
Accept: */*
Content-Length: 429

{
  "tick": "BTC",
  "payer_btc_addr": "tb1pf0tcpgxr30kqhh2gn3pgvr4qyachzm0xxydnfxth5cxlkjl37ugspxp7tm",
  "payer_ord_addr": "tb1pf0tcpgxr30kqhh2gn3pgvr4qyachzm0xxydnfxth5cxlkjl37ugspxp7tm",
  "fee_rate": 1,
  "inscription_ids": [],
  "is_multi_sign_trade": true,
  "coin_type": "btc",
  "value": "100000000",
  "payer_pub_key": "03786f146fa5031d05f5e81a2e983a6747f4444762e90b717b15633e9e043a16b9:03786f146fa5031d05f5e81a2e983a6747f4444762e90b717b15633e9e043a16b9"
}

200

Success

{
  "code": 0,
  "msg": "",
  "data": {
    "psbt": "cHNidP8BALICAAAAAhqZer8gWsqdj3vXJNByAE4LpD+CQwWgRlJ8Q5OW5UTTAQAAAAD/////gaKTIffhgQXSFzGfXP5KnxmMJj14ujUxjRS9Ot5sZSsAAAAAAP////8CwLX3BQAAAAAiACCUy8Bp0Nom9xDzHNfMro6zKQxtuKTEF/jpBAqlqS8vVK1DnAAAAAAAIlEgS9eAoMOL7AvdSJxChg6gJ3FxbeYxGzSZd6YN+0vx9xEAAAAAAAEBK7QlkgYAAAAAIlEgS9eAoMOL7AvdSJxChg6gJ3FxbeYxGzSZd6YN+0vx9xEBAwQBAAAAARcgeG8Ub6UDHQX16BoumDpnR/RER2LpC3F7FWM+ngQ6FrkAAQErwNQBAAAAAAAiACCUy8Bp0Nom9xDzHNfMro6zKQxtuKTEF/jpBAqlqS8vVAEDBAEAAAABBXBjVrJ1IQN4bxRvpQMdBfXoGi6YOmdH9ERHYukLcXsVYz6eBDoWuaxnUiEDeG8Ub6UDHQX16BoumDpnR/RER2LpC3F7FWM+ngQ6FrkhAhlnloiK8T7oBgt7/fXgToXct2fPkrRaacEfp0Hj3QN/Uq5oAAAA",
    "ToSignInputs": [
      {
        "index": 0,
        "type": "btc"
      },
      {
        "index": 1,
        "type": "btc"
      }
    ]
  },
  "req_id": "1925121877188354048"
}

Create commit order based on PSBT

post

/brc20swap/create_deposit_order_by_psbt

Header parameters

CookiestringRequiredExample: <Cookie>

Content-TypestringRequiredExample: <Content-Type>

Body

psbtstringRequired

tickstringRequired

payer_ord_addrstringRequired

inscription_idsstring[]Optional

amountstringRequired

Used to construct records

fee_ratestringRequired

is_multi_sign_tradebooleanRequired

Responses

200

Success

application/json

post

/brc20swap/create_deposit_order_by_psbt

POST /brc20swap/create_deposit_order_by_psbt HTTP/1.1
Host: api.dotswap.app
Cookie: text
Content-Type: application/json
Accept: */*
Content-Length: 1064

{
  "tick": "BTC",
  "payer_btc_addr": "tb1pf0tcpgxr30kqhh2gn3pgvr4qyachzm0xxydnfxth5cxlkjl37ugspxp7tm",
  "payer_ord_addr": "tb1pf0tcpgxr30kqhh2gn3pgvr4qyachzm0xxydnfxth5cxlkjl37ugspxp7tm",
  "fee_rate": 1,
  "inscription_ids": [],
  "is_multi_sign_trade": true,
  "coin_type": "btc",
  "psbt": "cHNidP8BALICAAAAAhqZer8gWsqdj3vXJNByAE4LpD+CQwWgRlJ8Q5OW5UTTAQAAAAD/////gaKTIffhgQXSFzGfXP5KnxmMJj14ujUxjRS9Ot5sZSsAAAAAAP////8CwLX3BQAAAAAiACCUy8Bp0Nom9xDzHNfMro6zKQxtuKTEF/jpBAqlqS8vVK1DnAAAAAAAIlEgS9eAoMOL7AvdSJxChg6gJ3FxbeYxGzSZd6YN+0vx9xEAAAAAAAEBK7QlkgYAAAAAIlEgS9eAoMOL7AvdSJxChg6gJ3FxbeYxGzSZd6YN+0vx9xEBCEMBQYjD9dQ/4OkK0XjO6EwKncdwRY/cY9st8BiDrOc/Q8x/QF37jSmU748N4kGMnV+a0glfKFKvo30LwxRCdUXdyy4BAAEBK8DUAQAAAAAAIgAglMvAadDaJvcQ8xzXzK6OsykMbbikxBf46QQKpakvL1QiAgN4bxRvpQMdBfXoGi6YOmdH9ERHYukLcXsVYz6eBDoWuUcwRAIgQMUfWvrzkJXH9OElZAlF8yEK7Sf1CwyIDZjBnDWT7toCIH71rq6eedES4arumY8ZtzUWjqGChLbOJLT9Gbz3+U8uAQEDBAEAAAABBXBjVrJ1IQN4bxRvpQMdBfXoGi6YOmdH9ERHYukLcXsVYz6eBDoWuaxnUiEDeG8Ub6UDHQX16BoumDpnR/RER2LpC3F7FWM+ngQ6FrkhAhlnloiK8T7oBgt7/fXgToXct2fPkrRaacEfp0Hj3QN/Uq5oAAAA",
  "amount": "100000000"
}

200

Success

{
  "code": 0,
  "msg": "",
  "data": {
    "receiver_addr": "tb1qjn9uq6wsmgn0wy8nrntuet5wkv5scmdc5nzp078fqs92t2f09a2qvudlje",
    "order_id": "deposit_trading_1109775095749935105",
    "txid": "f94012a7c14448eac448eac14c3f033de36918be2e4e0bb0a6943f250348afac"
  },
  "req_id": "1925121894867345408"
}

Commit records

post

/brc20swap/deposit_records

Header parameters

AcceptstringRequiredExample: application/json, text/plain, */*

Accept-LanguagestringRequiredExample: en

ConnectionstringRequiredExample: keep-alive

OriginstringRequiredExample: http://test-fe.ddpurse.com:17510

RefererstringRequiredExample: http://test-fe.ddpurse.com:17510/

Sec-Fetch-DeststringRequiredExample: empty

Sec-Fetch-ModestringRequiredExample: cors

Sec-Fetch-SitestringRequiredExample: cross-site

User-AgentstringRequiredExample:

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36 Edg/130.0.0.0

Wallet-NamestringRequiredExample: unisat

Wallet-VerstringRequiredExample: 1.5.0

sec-ch-uastringRequiredExample: "Chromium";v="130", "Microsoft Edge";v="130", "Not?A_Brand";v="99"

sec-ch-ua-mobilestringRequiredExample: ?0

sec-ch-ua-platformstringRequiredExample: "macOS"

HoststringRequiredExample: test-api-proxy.ddpurse.com

Content-TypestringRequiredExample: application/json

Body

addressstringRequired

pageintegerRequired

page_sizeintegerRequired

is_multi_sign_tradebooleanOptional

Responses

200

Success

application/json

post

/brc20swap/deposit_records

POST /brc20swap/deposit_records HTTP/1.1
Host: api.dotswap.app
Accept: text
Accept-Language: text
Connection: text
Origin: text
Referer: text
Sec-Fetch-Dest: text
Sec-Fetch-Mode: text
Sec-Fetch-Site: text
User-Agent: text
Wallet-Name: text
Wallet-Ver: text
sec-ch-ua: text
sec-ch-ua-mobile: text
sec-ch-ua-platform: text

Content-Type: application/json
Content-Length: 80

{
  "address": "tb1qnqxyakytxdszv5ws4d3j6v0eq3895q22z0ag56",
  "page": 1,
  "page_size": 20
}

200

Success

{
  "code": 1,
  "msg": "text",
  "data": {
    "total": 1,
    "records": [
      {
        "record_type": "text",
        "coin_type": "text",
        "tick": "text",
        "amount": "text",
        "txid": "text",
        "timestamp": 1,
        "progress": "text"
      }
    ]
  },
  "req_id": "text"
}

Reclaim

Construct Bitcoin Channel reclaim PSBT

post

/brc20swap/get_trading_withdraw_psbt

Body

coin_typestringRequired

tickstringRequired

amountstringRequired

payer_btc_addressstringRequired

payer_ord_addressstringRequired

user_public_keystringRequired

fee_rateintegerRequired

Responses

200

Success

application/json

x-200:成功

Success

application/json

post

/brc20swap/get_trading_withdraw_psbt

POST /brc20swap/get_trading_withdraw_psbt HTTP/1.1
Host: api.dotswap.app
Content-Type: application/json
Accept: */*
Content-Length: 386

{
  "coin_type": "btc",
  "tick": "btc",
  "amount": "10000",
  "fee_rate": 1,
  "payer_btc_address": "tb1pf0tcpgxr30kqhh2gn3pgvr4qyachzm0xxydnfxth5cxlkjl37ugspxp7tm",
  "payer_ord_address": "tb1pf0tcpgxr30kqhh2gn3pgvr4qyachzm0xxydnfxth5cxlkjl37ugspxp7tm",
  "user_public_key": "03786f146fa5031d05f5e81a2e983a6747f4444762e90b717b15633e9e043a16b9:03786f146fa5031d05f5e81a2e983a6747f4444762e90b717b15633e9e043a16b9"
}

{
  "code": 0,
  "msg": "",
  "data": {
    "order_id": "withdraw_trading_1084379288897060864",
    "psbt": "cHNidP8BAIkCAAAAAVBln3QXCmSfoVVJXwQRAgnL4O8aFiG5SXo8cXOGMSmtAAAAAAD/////AvBJAgAAAAAAIgAglMvAadDaJvcQ8xzXzK6OsykMbbikxBf46QQKpakvL1RFJgAAAAAAACJRIEvXgKDDi+wL3UicQoYOoCdxcW3mMRs0mXemDftL8fcRAAAAAAABASsAcQIAAAAAACIAIJTLwGnQ2ib3EPMc18yujrMpDG24pMQX+OkECqWpLy9UAQMEAQAAAAEFcGNWsnUhA3hvFG+lAx0F9egaLpg6Z0f0REdi6QtxexVjPp4EOha5rGdSIQN4bxRvpQMdBfXoGi6YOmdH9ERHYukLcXsVYz6eBDoWuSECGWeWiIrxPugGC3v99eBOhdy3Z8+StFppwR+nQePdA39SrmgAAAA=",
    "check_sign_only": false
  },
  "req_id": "1899726086142025728"
}

Signed reclaim PSBT for Bitcoin Channel

post

/brc20swap/submit_trading_withdraw_psbt

Body

order_idstringRequired

psbtstringRequired

is_base64booleanRequired

Responses

200

Success

application/json

x-200:成功

Success

application/json

post

/brc20swap/submit_trading_withdraw_psbt

POST /brc20swap/submit_trading_withdraw_psbt HTTP/1.1
Host: api.dotswap.app
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "order_id": "",
  "psbt": "",
  "is_base64": false
}

{
  "code": 0,
  "msg": "",
  "data": {
    "ID": 1147,
    "OrderId": "withdraw_trading_1084380100528439296",
    "FeeTxid": "fd2acb1f5b695d63cb1b32f4b1bc00ec9cd471942498a242156fb4ffb923aa28",
    "FeeAmount": 0,
    "FeeReceiveAddr": "",
    "FeeRate": 1,
    "FeePayMethod": "wallet",
    "Txid": "fd2acb1f5b695d63cb1b32f4b1bc00ec9cd471942498a242156fb4ffb923aa28",
    "SenderAddr": "tb1qjn9uq6wsmgn0wy8nrntuet5wkv5scmdc5nzp078fqs92t2f09a2qvudlje",
    "ReceiverAddr": "tb1pf0tcpgxr30kqhh2gn3pgvr4qyachzm0xxydnfxth5cxlkjl37ugspxp7tm",
    "Amount": "10000",
    "CoinType": "btc",
    "Tick": "btc",
    "Status": "init",
    "ErrMsg": "",
    "CreatedAtSec": 1741765272,
    "UpdatedAtSec": 1741765272
  },
  "req_id": "1899727358329610240"
}

Reclaim records

post

/brc20swap/withdraw_records

Header parameters

AcceptstringRequiredExample: application/json, text/plain, */*

Accept-LanguagestringRequiredExample: en

ConnectionstringRequiredExample: keep-alive

OriginstringRequiredExample: http://test-fe.ddpurse.com:17510

RefererstringRequiredExample: http://test-fe.ddpurse.com:17510/

Sec-Fetch-DeststringRequiredExample: empty

Sec-Fetch-ModestringRequiredExample: cors

Sec-Fetch-SitestringRequiredExample: cross-site

User-AgentstringRequiredExample:

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36 Edg/130.0.0.0

Wallet-NamestringRequiredExample: unisat

Wallet-VerstringRequiredExample: 1.5.0

sec-ch-uastringRequiredExample: "Chromium";v="130", "Microsoft Edge";v="130", "Not?A_Brand";v="99"

sec-ch-ua-mobilestringRequiredExample: ?0

sec-ch-ua-platformstringRequiredExample: "macOS"

HoststringRequiredExample: test-api-proxy.ddpurse.com

Content-TypestringRequiredExample: application/json

Body

addressstringRequired

pageintegerRequired

page_sizeintegerRequired

is_multi_sign_tradebooleanOptional

Responses

200

Success

application/json

post

/brc20swap/withdraw_records

POST /brc20swap/withdraw_records HTTP/1.1
Host: api.dotswap.app
Accept: text
Accept-Language: text
Connection: text
Origin: text
Referer: text
Sec-Fetch-Dest: text
Sec-Fetch-Mode: text
Sec-Fetch-Site: text
User-Agent: text
Wallet-Name: text
Wallet-Ver: text
sec-ch-ua: text
sec-ch-ua-mobile: text
sec-ch-ua-platform: text

Content-Type: application/json
Content-Length: 80

{
  "address": "tb1qnqxyakytxdszv5ws4d3j6v0eq3895q22z0ag56",
  "page": 1,
  "page_size": 20
}

200

Success

{
  "code": 1,
  "msg": "text",
  "data": {
    "total": 1,
    "records": [
      {
        "record_type": "text",
        "coin_type": "text",
        "tick": "text",
        "amount": "text",
        "txid": "text",
        "timestamp": 1,
        "progress": "text"
      }
    ]
  },
  "req_id": "text"
}

Note: For all the endpoints related to the Bitcoin Channel mentioned above, the parameter is_multi_sign_trade must be set to true.

PreviousTrading NextSingle Side Actions

Last updated 7 months ago