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

string · numericOptionalDefault: 0

or

numberOptional

isExpressBuybooleanOptional

receiverstringOptional

Responses

200Success

application/jsonmultipart/form-datatext/plain

post

/market/v1/{market}/bulk-buy

HTTPcURLJavaScriptPython

POST /market/v1/{market}/bulk-buy HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 119

{
  "bidIds": [
    "text"
  ],
  "buyer": "text",
  "gasRate": 0,
  "isExpressBuy": true,
  "receiver": "text",
  "utxos": [
    {
      "txid": "text",
      "vout": 1
    }
  ]
}

application/jsonmultipart/form-datatext/plain

200Success

{
  "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

200Success

application/jsonmultipart/form-datatext/plain

post

/market/v1/bid/bulk-confirm

HTTPcURLJavaScriptPython

POST /market/v1/bid/bulk-confirm HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "psbt": "text",
  "bidIds": [
    "text"
  ]
}

application/jsonmultipart/form-datatext/plain

200Success

{
  "success": true
}