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

# Auctions

Instead of a set price, put a card up and let people bid on it. Highest bid when time's up wins. Want to just sell it outright instead? Check Marketplace: Listings.

| Command                                                | What it does                                        |
| ------------------------------------------------------ | --------------------------------------------------- |
| `%auction <card id or code> <starting bid> [currency]` | Start a 30 minute auction for a card you own        |
| `%auctions`                                            | Browse what's up for auction, 10 per page           |
| `%bid [cards\|posters]`                                | Browse and place bids                               |
| `%unlist <card id or code>`                            | Cancel your auction, only works if nobody's bid yet |

`[currency]` works the same everywhere, any currency, its nickname, or its emoji. See Currencies & Daily Rewards. Gold's the default.

Example: `%auction n7FQHj 1000 gems` starts an auction opening at 1,000 Gems.

Free accounts can have a handful of listings and auctions active at once combined - Tome+ raises that cap, see Currencies & Daily Rewards.

## How it works

1. Every auction runs for exactly 30 minutes. It doesn't get extended even if someone bids right at the last second.
2. Pick an auction from `%auctions` or `%bid` and you'll get a little popup to type your bid.
3. The first bid has to at least match the starting bid. Every bid after that has to beat the current one by at least 1.
4. The second you bid, that amount gets locked away from the rest of your wallet, so you need the full amount to bid at all. Get outbid and you get it back automatically, right away, no need to do anything.
5. You can't bid on your own auction.

## How it ends

The bot checks every 60 seconds for auctions that just wrapped up, so results show up within about a minute of the timer hitting zero.

If someone won, the seller gets paid, the card goes to the winner, and both people get a DM about it. If nobody bid at all, the card just goes back to the seller untouched and they get a DM saying so.

Once an auction's got a bid, `%unlist` won't cancel it anymore. It has to run its course, since cancelling would leave the bidder's money stuck.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://studio0.gitbook.io/tome-docs/auctions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.