> For the complete documentation index, see [llms.txt](https://docs.rip.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rip.xyz/marketplace-guides/auctions.md).

# Auctions

Create NFT auctions, place funded bids, and settle the result.

An auction locks a single NFT in the seller's marketplace vault. Bids are funded immediately. The end time stops new bids; a separate settlement transaction completes the outcome.

## Start an auction

1. Open an NFT you own and choose the auction form in **Owner Controls**.
2. Approve the collection if requested.
3. Set the reserve price, start delay, and end time. Prices use multiples of <code class="expression">space.vars.marketplace\_price\_tick</code>.
4. Review the estimated fee and proceeds at reserve, then select **Start auction** and confirm.

The website permits a start delay of up to <code class="expression">space.vars.marketplace\_auction\_max\_start\_delay\_hours</code> hours. The end must be after the start and no more than <code class="expression">space.vars.marketplace\_auction\_max\_duration\_days</code> days later. The contract allows an additional <code class="expression">space.vars.marketplace\_auction\_start\_tolerance\_minutes</code> minutes of timing tolerance on that maximum start delay; use the website's stricter form limits.

The marketplace creates your [seller vault](https://docs.rip.xyz/marketplace-guides/profile-and-vaults.md#seller-vaults) if needed and moves the NFT there. The website requires you to cancel an existing listing before starting an auction. A direct `createAuction` call also removes any existing fixed-price listing atomically. You cannot withdraw the auction's locked custody through the vault's excess-asset recovery functions.

## Bid

Open the auction and check the seller, NFT, reserve or current bid, payment token, start, and end. The first bid must meet the reserve and be positive. Later bids must be at least <code class="expression">space.vars.marketplace\_bid\_increment\_bps / 100 + "%"</code> above the current highest bid, rounded up to an accepted price increment. Use the minimum shown by the form.

Native bids require the full bid amount plus gas. An allowed ERC20 auction also requires sufficient balance and allowance. The highest bid is held by the marketplace. The seller cannot bid on their own auction.

When a new bid succeeds, the previous highest bidder is refunded. A native refund can arrive as wrapped tokens if native delivery fails. An unsuccessful ERC20 refund can become a [payment credit](https://docs.rip.xyz/marketplace-guides/payments-and-recovery.md#withdraw-a-payment-credit).

You cannot cancel or withdraw a winning bid yourself. Even when increasing your own highest bid, keep the full new bid amount available: the contract collects the new bid before refunding the old one. Bids do not extend the end time.

## Cancel before any bid

Only the seller can cancel an auction, and only if it has no bids. Submit cancellation through the owner controls. Once a bid is accepted, the auction must reach its end and be settled. A disconnected wallet does not cancel an auction.

## Settle after the end

Use **Settle** when available after the end time. Anyone can submit settlement and pays that transaction's gas; the contract determines the recipient and proceeds.

| Result                                | What settlement does                                                                                      |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Winning bid and successful delivery   | Transfers the NFT to the winner and pays the seller less the settlement-time fee.                         |
| No bids                               | Attempts to return the NFT to the seller.                                                                 |
| NFT cannot be delivered to the winner | Cancels the auction outcome, refunds or credits the winner, and leaves the NFT recoverable by the seller. |
| NFT cannot be returned to the seller  | Leaves it in the seller vault as an excess asset for owner recovery to a working address.                 |

The timer reaching zero is not proof of settlement. Check the receipt and auction activity. If a recipient wallet cannot receive the NFT, use the [seller-vault recovery instructions](https://docs.rip.xyz/marketplace-guides/profile-and-vaults.md#recover-excess-assets) after the auction releases its tracked custody.
