Assets Buying

Workflow for assets buying.

1. Prepare buying

post

Prepare buy

Path parameters

marketanyrequired

"token"|"collection|"realm"

Body

application/jsonmultipart/form-datatext/plain

bidIdsstring[]required

buyerstringrequired

gasRateany ofrequired

isExpressBuybooleanoptional

receiverstringoptional

utxosobject[]optional

Responses

application/jsonmultipart/form-datatext/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/market/v1/{market}/bulk-buy' \
  --header 'Content-Type: application/json' \
  --data '{
    "bidIds": [
      "text"
    ],
    "buyer": "text",
    "gasRate": "text",
    "isExpressBuy": true,
    "receiver": "text",
    "utxos": [
      {
        "txid": "text",
        "vout": 1
      }
    ]
  }'

application/jsonmultipart/form-datatext/plain

200

200

application/json

multipart/form-data

text/plain

application/json

{
  "bidIds": [
    "text"
  ],
  "gasCost": 1,
  "psbt": "text",
  "serviceFee": 1,
  "txSize": 1,
  "signIndexes": [
    1
  ]
}

1. Client sign psbt from last step's response

const signedPsbt = await unisat.signPsbt(psbt, {
	autoFinalized: false
})

1. Confirm buying psbt in the post body is last step's signedPsbt

post

Confirm listing

Body

application/jsonmultipart/form-datatext/plain

psbtstringrequired

Signed psbt

bidIdsstring[]required

Responses

application/jsonmultipart/form-datatext/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/market/v1/bid/bulk-confirm' \
  --header 'Content-Type: application/json' \
  --data '{
    "psbt": "text",
    "bidIds": [
      "text"
    ]
  }'

application/jsonmultipart/form-datatext/plain

200

200

application/json

multipart/form-data

text/plain

application/json

{
  "success": true
}