> ## Documentation Index
> Fetch the complete documentation index at: https://86d.store/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Auctions

> Time-limited product auctions with live bidding for 86d. Reserve prices, automatic bid increments, and winner notifications.

<Warning>
  **Experimental.** This Module has no test or production evidence recorded yet. Read it, run it locally, and hold off on real Orders. See [maturity levels](/docs/resources/versioning).
</Warning>

The Auctions [Module](/docs/concepts/modules) turns selected products into time-limited auctions. [Customers](/docs/resources/glossary#customer) place bids; the Module enforces the minimum bid increment, holds reserve prices, and notifies the winner when the auction closes. On confirmation, the winning bid becomes an [Order](/docs/concepts/commerce-model).

**Source:** [`modules/auctions`](https://github.com/86d-store/86d/tree/main/modules/auctions) · **npm:** [`@86d-store/auctions`](https://www.npmjs.com/package/@86d-store/auctions)

## Installation

```sh theme={null}
86d module add auctions
```

## Store endpoints

| Method | Path                | Description     |
| ------ | ------------------- | --------------- |
| `GET`  | `/auctions`         | Active auctions |
| `GET`  | `/auctions/:id`     | Auction detail  |
| `POST` | `/auctions/:id/bid` | Place a bid     |

## Admin endpoints

| Method | Path                      | Description       |
| ------ | ------------------------- | ----------------- |
| `POST` | `/admin/auctions`         | Create an auction |
| `POST` | `/admin/auctions/:id/end` | Force-close       |

## Components

* `<AuctionDetail id={id} />`
* `<BidForm auctionId={id} />`
* `<LiveBidFeed auctionId={id} />`

## Related pages

* [Notifications](/docs/modules/notifications)
* [Orders](/docs/modules/orders)
* [How commerce records relate](/docs/concepts/commerce-model)
* [Versioning and maturity](/docs/resources/versioning)
* [Glossary](/docs/resources/glossary)
