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

# Buy & Sell

> Execute market orders on Polymarket prediction markets directly from Telegram. Trades fill instantly using real-time orderbook pricing.

All trades are Fill-or-Kill (FOK) market orders, meaning each order either fills completely at the best available price or is not filled at all — you are never left with a partial position.

The minimum trade amount is **\$1.00**. A **1% fee** applies to every trade.

<Tabs>
  <Tab title="Buying">
    <Steps>
      <Step title="Browse to a market and select an outcome">
        Find a market using `/markets`, `/sports`, a keyword search, or a pasted Polymarket URL. On the market card, tap the outcome you want to buy — for example, **Yes** or **Lakers to win**.
      </Step>

      <Step title="Choose an amount">
        You'll see preset buttons — **$10**, **$25**, and **$50** — or tap **Custom $** to enter any amount. The minimum is \$1.00.

        Before you confirm, Overdog checks the live orderbook to calculate your real fill price and estimated shares.
      </Step>

      <Step title="Review the confirmation">
        The confirmation screen shows:

        | Field          | Description                                       |
        | -------------- | ------------------------------------------------- |
        | **Outcome**    | What you're buying                                |
        | **Fill price** | Estimated average price from the orderbook        |
        | **Shares**     | Estimated shares you'll receive                   |
        | **Total**      | Dollar amount you're spending                     |
        | **Fee**        | 1% of your total (deducted from the trade amount) |

        If the orderbook price differs from the mid-price, both are shown so you know exactly what to expect.
      </Step>

      <Step title="Confirm to execute">
        Tap **Confirm**. The order is submitted immediately. A success message shows your filled shares, fill price, and a link to the on-chain transaction.
      </Step>
    </Steps>

    <Note>
      If the orderbook shifts between when you review and when you confirm, the Fill-or-Kill order may not be filled. You'll see a "Price moved too fast" message and can tap **Retry** to try again with fresh pricing.
    </Note>
  </Tab>

  <Tab title="Selling">
    <Steps>
      <Step title="Open your positions">
        Send `/positions` and tap the position you want to sell.
      </Step>

      <Step title="Choose how much to sell">
        You'll see preset buttons for **25%**, **50%**, and **100%** of your shares, or tap **Custom** to type an exact share count. To close the entire position, use the **Sell All** button.
      </Step>

      <Step title="Review the confirmation">
        The confirmation screen shows:

        | Field          | Description                                |
        | -------------- | ------------------------------------------ |
        | **Outcome**    | The position you're selling                |
        | **Fill price** | Estimated average price from the orderbook |
        | **Shares**     | Number of shares to sell                   |
        | **Proceeds**   | Estimated amount you'll receive            |
        | **Fee**        | 1% of your proceeds                        |

        Realized P\&L is shown on the result screen after the trade fills.
      </Step>

      <Step title="Confirm to execute">
        Tap **Confirm**. The order is submitted and fills immediately if liquidity is available.
      </Step>
    </Steps>

    <Note>
      If the orderbook shifts between review and confirmation, the order may not fill. Tap **Retry** to start the sell flow again with updated pricing.
    </Note>
  </Tab>
</Tabs>

## Slippage and pricing

Overdog walks the live orderbook to calculate your fill price before you confirm. This means the price shown reflects the actual depth of the market, not just the mid-price.

The default slippage tolerance is **3%**. If the final execution price would exceed this threshold, the Fill-or-Kill order is rejected and you can retry.

## Sell All

From `/positions`, tap **Sell All** to close every open position at once. You'll see a confirmation before anything is submitted. Positions with wide bid-ask spreads are flagged so you can decide whether to include them.