# User Guides

<details>

<summary>How to Trade Cards</summary>

1. **Creating a Trade Offer**:
   * Use `/trade offers create`
   * Select up to 3 cards from your inventory to offer
   * Optionally add a point value
   * Confirm your offer
2. **Viewing Trade Offers**:
   * Use `/trade offers list` to see all active offers
   * Browse offers in the Trading channel
3. **Accepting a Trade**:
   * Click the "Accept Trade" button on any trade offer
   * Review the trade details carefully
   * Confirm to complete the trade
4. **Canceling Your Trade Offer**:
   * Use `/trade offers cancel {offerId}`
   * The offer will be removed from the list and channel

Note: Trade offers expire after 24 hours if not accepted.

</details>

<details>

<summary>Checking Your Inventory</summary>

* Use the `/inventory` command to see all your collected items
* Your inventory displays:
  * Cards organized by collection
  * Rarity information
  * Point balance
  * Direct link to your wallet login

</details>

<details>

<summary>Tracking Your Progress</summary>

1. Use the `/progress` command to check your collection status
2. The progress view shows:
   * Collection completion percentage
   * Owned vs. missing cards
   * Direct reward claims available
   * Quick access to your Giftoin App profile

</details>

<details>

<summary>Setting Up the Bot (Admin Guide)</summary>

1. **Initial Setup**:
   * Use `/setup` in any channel
   * Enter your authorization code when prompted
   * Wait for the setup process to complete
2. **Configuring Channels**:
   * After setup, all required channels will be created
   * You can rename channels without affecting functionality
   * Customize channel permissions as needed
3. **Role Assignment**:
   * Use `/grant-role` to assign Giftoin Admin or Moderator roles
   * Members role is assigned automatically through interaction
4. **Publishing the Bot**:
   * Use `/publish` when ready to make the bot available to all members
   * Ensure all mandatory channels exist before publishing
   * Configure audience access settings as needed

</details>

<details>

<summary>Managing Giveaways</summary>

* Use `/giveaway create`
* Set the prize, duration, and winner count
* Configure announcement settings:
  * Public announcements
  * Private DM notifications (at least one method required)
* Set duration using the "1m 1h 1d" format (e.g., "2h 30m" for 2 hours and 30 minutes)
* **Monitoring Active Giveaways**:
  * Use `/giveaway list` to view all active and scheduled giveaways
  * Filter by status (in-progress/scheduled)
* **Viewing Giveaway Details**:
  * Use `/giveaway view {giveawayId}` to see:
    * Configuration settings
    * Participation data
    * Winner information (if ended)
* **Canceling a Giveaway**:
  * Use `/giveaway cancel` and select the giveaway to cancel
  * Confirm cancellation when prompted

</details>

<details>

<summary>Viewing Statistics</summary>

1. Use `/admin stats` to access comprehensive metrics
2. Available statistics include:
   * Daily and weekly usage
   * Trading activity
   * User engagement
   * Giveaway participation
   * Collection completion rates

</details>


---

# Agent Instructions: 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:

```
GET https://docs.giftoin.org/platform-guides/discord/user-guides.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.