Bitcoin Channel
Commit
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
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"
}
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
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"
}
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
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
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
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"
}
Body
order_idstringRequired
psbtstringRequired
is_base64booleanRequired
Responses
200
Success
application/json
x-200:成功
Success
application/json
post
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"
}
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
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
.
Last updated