Skip to content

Bid on an auction sale

POST
/collection/{highlightId}/sales/bid

Build a bid transaction configuration for an auction sale. For ranked auctions, places or updates an on-chain bid. For English auctions, returns an executor-signed bid claim plus the AuctionManager.bid call (with value = the bid amount); the optional preferredNftRecipient sets where the NFT is delivered if this bidder wins.

highlightId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
object
saleId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
bidAmount
required
string
>= 1 characters
bidId
integer
<= 9007199254740991
preferredNftRecipient
string
>= 1 characters

Bid transaction configuration

object
chainId
required
integer
> 0 <= 9007199254740991
to
required
Any of:
string
data
required
string
value
required
string

Invalid request

Unauthorized

Not found