Let's wall through the steps involved for accepting a bid on your item via the API on Satflow.
This is for an individual item bid only (not a collection bid).
There are several steps involved in accepting a bid:
- Find a bid on your item with
/item
- Generate the bid acceptance PSBT for signing
/intent/accept
- Sign and submit the bid acceptance PSBT to
/fillBid
for validation and broadcasting.
Generate a bid acceptance PSBT
You need a few things to generate a bid acceptance PSBT
inscription_id
The inscription id to accept a bid ofseller_public_key
The public key of current address location of the ordinal, usually 66 characters long, and is hexadecimal format
Now you need to POST /intent/accept
with these included in the body.
You will receive psbtBast64
for signing.
Signing PSBTs using local wallet software
Sign all inputs of the PSBT using a wallet of your choice.
Submitting the signed PSBT to /fillBid
Now that you have a signed PSBT, you will need to reuse the original parameters which generated the listing (required fields in section 1 of this guide).
In addition to those parameters you need:
price
The price of the bid you want to sell your item for in Satoshisseller_ord_address
Your seller ordinal address for where the inscription is currently locatedseller_receive_address
Your seller payment receiving addresssigned_accepted_bid_psbt
The signed bid acceptance PSBT formatted as base64 or hexunsigned_accept_bid_psbt
This is the unsigned bid acceptance PSBT from above
POST /fillBid
with these parameters to sell your item for the bid!