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

# Shares

> Trade server shares, build a portfolio, claim dividends, and list your own server on the market.

# Shares

> Trade server shares, build a portfolio, claim dividends, and list your own server on the market.

## Overview

The share market lets users invest in Discord servers. Each listed server has shares you can buy and sell. Prices rise with demand (more buying = higher price). Shareholders earn **dividends** over time.

<Frame caption="Share market">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/raze/images/eco/shares.png" alt="Share market listing" />
</Frame>

***

## Browsing the market

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares
    ```

    *Aliases: `;stock`, `;stocks`*

    Lists all servers with active share listings. Columns: server name, ticker symbol, current price, 24h price change, and market cap.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares
    ```

    Lists all servers with active share listings. Columns: server name, ticker symbol, current price, 24h price change, and market cap.
  </Tab>
</Tabs>

***

## Share details

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares info (guild_id)
    ```

    Deep-dive into a specific server's shares:

    * Base price, current price, total supply
    * 24h price change
    * ASCII price history chart (last 30 data points)
    * Top shareholders
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares info
    ```

    Deep-dive into a specific server's shares:

    * Base price, current price, total supply
    * 24h price change
    * ASCII price history chart (last 30 data points)
    * Top shareholders
  </Tab>
</Tabs>

***

## Buying shares

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares buy (amount) (guild_id)
    ```

    Buys shares in a server. A confirmation prompt shows the total cost and your wallet before/after. If no `guild_id` is specified, the command uses the current server.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares buy 10
    ```

    Buys shares in a server. A confirmation prompt shows the total cost and your wallet before/after. If no `guild_id` is specified, the command uses the current server.
  </Tab>
</Tabs>

**Price formula:**

```
current_price = base_price × f(total_sold)
```

As more shares are sold, the price increases. Early buyers get better prices.

***

## Selling shares

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares sell (amount) (guild_id)
    ```

    Sells shares back to the market. Shows your profit/loss compared to your average buy price.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares sell 5
    ```

    Sells shares back to the market. Shows your profit/loss compared to your average buy price.
  </Tab>
</Tabs>

***

## Portfolio

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares portfolio
    ```

    *Aliases: `;shares holdings`, `;shares folio`*

    Your complete share portfolio. For every holding:

    * Server name and ticker
    * Shares owned and average buy price
    * Current price
    * P\&L amount and percentage

    Total portfolio value shown in the footer.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares portfolio
    ```

    Your complete share portfolio. For every holding:

    * Server name and ticker
    * Shares owned and average buy price
    * Current price
    * P\&L amount and percentage

    Total portfolio value shown in the footer.
  </Tab>
</Tabs>

***

## Dividends

Passive income from your share holdings. Each server sets a dividend rate (0.1%–1% per day). The longer you hold, the more you earn.

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares dividend
    ```

    *Alias: `;shares div`*

    Claims dividends from **all** your holdings at once. The payout for each server is:

    ```
    payout = shares_owned × current_price × daily_rate × days_since_last_claim
    ```
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares dividend
    ```

    Claims dividends from **all** your holdings at once. The payout for each server is:

    ```
    payout = shares_owned × current_price × daily_rate × days_since_last_claim
    ```
  </Tab>
</Tabs>

<Tip>
  Claim dividends regularly to compound your earnings back into more shares.
</Tip>

***

## Price history

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares history (guild_id)
    ```

    ASCII price chart showing the last 30 price data points for a server's shares.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares history
    ```

    ASCII price chart showing the last 30 price data points for a server's shares.
  </Tab>
</Tabs>

***

## Trade history

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares trades @member
    ```

    Last 10 trades for yourself or another user. Shows buy/sell, amount, price per share, and timestamp.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares trades @wanderer
    ```

    Last 10 trades for yourself or another user. Shows buy/sell, amount, price per share, and timestamp.
  </Tab>
</Tabs>

***

## Top shareholders

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;shares top (guild_id)
    ```

    Top 10 shareholders for a server's shares.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;shares top
    ```

    Top 10 shareholders for a server's shares.
  </Tab>
</Tabs>

***

## Listing your server

Server admins can list their Discord server on the share market.

<AccordionGroup>
  <Accordion title="List shares">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;shares list (base_price) (ticker)
        ```

        Requires **Manage Server**. Sets the base price ($10–$100,000) and optionally a ticker name (max 8 characters). Creates your server's listing on the market.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;shares list 5000 WAND
        ```

        Requires **Manage Server**. Sets the base price ($10–$100,000) and optionally a ticker name (max 8 characters). Creates your server's listing on the market.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Update listing">
    All require **Manage Server**.

    ```bash theme={null} theme={null}
    ;shares setdesc (description)
    ```

    Update the server description shown on the market listing.

    ```bash theme={null} theme={null}
    ;shares setrate (rate)
    ```

    Set the dividend rate (0.001–0.01).

    ```bash theme={null} theme={null}
    ;shares rename (ticker)
    ```

    Rename the ticker symbol (max 8 chars).

    ```bash theme={null} theme={null}
    ;shares setprice (price)
    ```

    Update the base price ($10–$100,000).
  </Accordion>

  <Accordion title="Delist">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;shares delist
        ```

        Requires **Manage Server**. Removes your server from the market. Existing holders keep their shares but can no longer trade them.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;shares delist
        ```

        Requires **Manage Server**. Removes your server from the market. Existing holders keep their shares but can no longer trade them.

        <Warning>
          Delisting does not refund existing shareholders. Do this only if you intend to permanently leave the market.
        </Warning>
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>