Fill/accept a bid

post

https://api.satflow.com/v1/bid/fill

Submit signed PSBT to fill/accept either an inscription bid or collection bid (including trait-constrained collection bids) and broadcast the item sale. The endpoint automatically detects the bid type based on the provided parameters.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

price

number

required

Bid price in satoshis

inscriptionId

string

required

Inscription ID for the bid

sellerOrdAddress

string

required

Seller's ordinal address

sellerReceiveAddress

string

required

Address to receive payment

sellerPaymentAddress

string

Optional payment address for split-address payouts. Requires signedAcceptBidExtractionPSBT when it differs from sellerReceiveAddress.

sellerPublicKey

string

required

Seller's public key

signedAcceptedBidPSBT

string

required

Signed accept bid PSBT in base64 format

unsignedAcceptBidPSBT

string

Unsigned accept bid PSBT in base64 format (optional)

signedAcceptBidExtractionPSBT

string

Signed extraction PSBT in base64 format. Required when proceeds move to sellerPaymentAddress.

unsignedAcceptBidExtractionPSBT

string

Unsigned extraction PSBT in base64 format (optional)

referralAddress

string

Referral address for commission (optional)

skipBroadcast

boolean

Defaults to false

Whether to skip broadcasting the transaction

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Bid filled successfully

400Invalid parameters

500Internal server error