Place bid

Server URLloading...

POST

/v2/tx/auctions/bid

Send

Authorization

Body

Builds a bid of bidAmount on asset's auction, signed and paid for by bidder. The bid must meet the reserve price and beat the current bid by the minimum increment.

The previous high bidder is refunded when the bid confirms. If their wallet can't receive the refund, it is held for them to withdraw; see GET /v2/auctions/bid-refunds/{bidder}.

Returns 400 if the asset has no active auction, or if the auction is restricted to an allowlist the bidder isn't on.

Warn bidders: a Core asset or collection with a Permanent* delegate plugin can be auctioned. If the delegate burns, moves or freezes the asset before settlement, the sale can't complete and the refund goes through support@mallow.art. After settlement, the bid can't be refunded.

Response Body

curl -X POST "https://example.com/v2/tx/auctions/bid" \  -H "Content-Type: application/json" \  -d '{    "bidder": "string",    "asset": "string",    "bidAmount": 0  }'

{  "result": {    "tx": "string"  }}