Place a bid on an inscription or collection

post

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

Submit a signed PSBT to place a bid on either a specific inscription or a collection. Collection bids can target the whole collection or specific traits.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

price

number

required

Bid price in satoshis

inscriptionId

string

required

Inscription ID to bid on

bidderAddress

string

required

Bidder's payment address

bidderTokenReceiveAddress

string

required

Address to receive the token if bid is accepted

signedBiddingPSBT

string

required

Signed bidding PSBT in base64 format

unsignedBiddingPSBT

string

Unsigned bidding PSBT in base64 format (optional)

allowedPaymentOutpoints

array of strings | null

Optional payment UTXO allowlist used when generating the bid intent. Include the same value returned/supplied to /intent/bid so signed PSBT verification can validate allowlisted funding inputs. Omit or send null to leave unset.

allowedPaymentOutpoints

feeRate

enum

Transaction fee rate option. Can be one of the predefined options (fastestFee, halfHourFee, hourFee, minimumFee) or a custom number sat/vB. Custom numeric bid fee rates use a 1 sat/vB minimum.

Responses

200Bid placed successfully

400Invalid parameters

500Internal server error