Settle auction
Builds the transaction that completes an ended auction. The asset goes to the winner, and the proceeds pay the marketplace fee, the creators' royalties and the seller. Anyone can sign as authority, so the winner doesn't have to wait for the seller.
An auction with an end time can only be settled after it. If no one bid, this returns the asset to the seller instead, and only the seller can sign.
Authorization
ApiKeyAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Closes out an ended auction: transfers the asset to the winning bidder and distributes proceeds. With no bids, it instead builds the reclaim path returning the asset to the seller.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v2/tx/auctions/settle" \ -H "Content-Type: application/json" \ -d '{ "authority": "string", "asset": "string" }'{ "result": { "tx": "string", "setupTx": "string" }}Cancel auction POST
Builds a transaction cancelling asset's auction and returning the asset to seller. Only an auction with no bids can be cancelled; otherwise wait for it to end and settle it with POST /v2/tx/auctions/settle.
Close missing auction POST
Builds a transaction that closes a compressed NFT auction whose asset has been burned or moved out of escrow, returning the rent to the seller. Anyone can sign and pay as payer.