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

# Trading Guide

> Master market and limit orders, understand fees, and execute winning trades

## Trading Basics

Onsight supports two types of orders on Polymarket: **Market Orders** for instant execution and **Limit Orders** for price control.

<CardGroup cols="2">
  <Card icon="bolt" title="Market Orders">
    **Instant execution** at the best available price. Perfect for fast-moving markets.
  </Card>

  <Card icon="list-check" title="Limit Orders">
    **Set a price** and wait for the market to match it. Best pricing but takes patience.
  </Card>
</CardGroup>

## Understanding Prediction Markets

Prediction markets let you trade on the outcome of real-world events. Each market has outcomes priced between 0.00 and 1.00:

* **\$0.65 = 65% probability** the outcome will happen
* **\$0.35 = 35% probability** it won't happen
* When the outcome resolves, winning shares pay **\$1.00 each**

<Tip>
  **Example:** If you buy 100 shares at 0.65, you pay \$65.00. If your prediction is correct, you receive \$100 (100 shares \* \$1.00) - earning \$35 profit.
</Tip>

## Executing a Trade

<Steps>
  <Step title="Find Your Market">
    Navigate to **Markets** and find a prediction market you want to trade.

    <Tabs>
      <Tab title="Search">
        1. Click **Search**
        2. Type keywords or phrases
        3. Select from results
      </Tab>

      <Tab title="Browse">
        1. Choose filter: Trending, Volume, New
        2. Scroll through markets
        3. Click to view details
      </Tab>

      <Tab title="Category">
        1. Click Category
        2. Select topic (Politics, Sports, etc.)
        3. Browse filtered results
      </Tab>
    </Tabs>
  </Step>

  <Step title="Choose Your Position">
    Select which outcome you want to trade:

    * **Yes** - Buy shares if you think it will happen
    * **No** - Buy shares if you think it won't happen

    You'll see:

    * Current price per share
    * Your available balance
    * Options to **Buy** or **Sell** (if you have position)
  </Step>

  <Step title="Select Trade Amount">
    Choose how much USDC.e you want to trade:

    **Preset Amounts:**

    * Quick select: 2, 5, 10, 25 (customizable in Settings)
    * Minimum: \$2.00 USDC.e
    * Maximum: Your available balance

    **Custom Amount:**

    * Click **Custom** button
    * Type your amount (e.g., 15.50)
    * Minimum 5 shares after fees required

    <Note>
      Amounts shown include the 1% trading fee. Example: 10 trade = \$9.90 to market and \$0.10 fee.
    </Note>
  </Step>

  <Step title="Choose Order Type">
    Select how you want your order to execute:

    <Tabs>
      <Tab title="Market Order">
        **Market** - Instant execution

        * Executes immediately at best available price
        * Fills from the order book right now
        * May have slippage on large orders
        * Best for: Fast execution, smaller amounts

        <Info>
          You'll see slippage warnings if market impact exceeds 5%. Consider using a limit order for better pricing on large trades.
        </Info>
      </Tab>

      <Tab title="Limit Order">
        \*\* Limit\*\* - Set your price

        * Choose your execution price
        * Order waits in the book until matched
        * Better pricing, but not guaranteed to fill
        * Optionally set expiration (1h to 7d)
        * Best for: Larger amounts, patient traders

        <Warning>
          Limit orders require minimum 5 shares. If your amount is too small, this option won't be available.
        </Warning>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Review and Confirm">
    Review the trade details before executing:

    **Check These Details:**

    * Total amount (including fee)
    * Estimated shares you'll receive
    * Execution price
    * Fee breakdown (1% of total)
    * Slippage (for market orders)

    <Check>
      When everything looks good, click **Execute** to place your order.
    </Check>
  </Step>

  <Step title="Track Your Order">
    After execution, you'll see confirmation:

    **Market Order:**

    * **Matched** - Order filled immediately
    * Order ID for reference
    * Actual execution price
    * Shares received

    **Limit Order:**

    * **Live** - Waiting in order book
    * Order ID for tracking
    * View in **Orders** menu
    * Cancel anytime before match

    <Tip>
      Use **Orders** to track all pending limit orders and see when they get filled.
    </Tip>
  </Step>
</Steps>

## Limit Order Pricing

When placing a limit order, you can set a custom price or choose from preset offsets:

<Tabs>
  <Tab title="Price Selection">
    **Default Price Options:**

    * **-5%** - 5% below current price (buy below market)
    * **-2%** - 2% below current price
    * **Current** - Current market price
    * **+2%** - 2% above current price
    * **+5%** - 5% above current price (sell above market)
    * **Custom** - Enter any price you want

    <Note>
      Price offsets are customizable in **⚙ Settings** → **Limit Orders**. Set your preferred offsets for faster trading.
    </Note>
  </Tab>

  <Tab title="Expiration Options">
    **Order Expiration:**

    * **1h** - Order expires in 1 hour
    * **6h** - Order expires in 6 hours
    * **24h** - Order expires in 1 day
    * **7d** - Order expires in 7 days
    * **GTC** - Good-til-cancelled (no expiration)

    If your order doesn't fill before expiration, it's automatically cancelled and funds are returned.

    <Tip>
      For markets with low volume, use longer expirations or GTC. For fast-moving markets, shorter expirations help you stay competitive.
    </Tip>
  </Tab>
</Tabs>

## Understanding Fees

Onsight charges a **1% fee on the total trade amount** to cover infrastructure and development.

### Fee Breakdown

<CodeGroup>
  ```txt Buy Example theme={null}
  User wants to trade $100
  ├─ $99.00 → Actual trade amount
  └─ $1.00 → Onsight fee (1%)

  Result: ~147 shares at $0.67/share
  ```

  ```txt Sell Example theme={null}
  User wants to sell $50 worth
  ├─ $49.50 → Actual sell proceeds
  └─ $0.50 → Onsight fee (1%)

  Result: User receives $49.50 to balance
  ```
</CodeGroup>

<AccordionGroup>
  <Accordion title="When are fees collected?">
    **Market Orders:** Fee collected immediately when order matches

    **Limit Orders:** Fee collected when order matches (not when placed)

    If your limit order gets cancelled, no fee is charged.
  </Accordion>

  <Accordion title="Are fees refundable?">
    No. Fees are final once an order matches. However, if you cancel a limit order before it matches, no fee is charged.
  </Accordion>

  <Accordion title="Why are fees charged?">
    Fees cover:

    * Infrastructure costs (servers, database, WebSocket connections)
    * Relayer network usage (gasless transactions)
    * Development and maintenance
    * 24/7 bot availability
    * Future feature development
  </Accordion>
</AccordionGroup>

## Selling Your Position

Once you own shares, you can sell them at any time:

<Steps>
  <Step title="Navigate to Position">
    From **Positions**, find the market you want to sell.

    You'll see:

    * Your position size (number of shares)
    * Current market value
    * Unrealized P\&L
  </Step>

  <Step title="Choose Sell Percentage">
    Select what portion of your position to sell:

    * **25%** - Sell quarter position
    * **50%** - Sell half position
    * **75%** - Sell three-quarters
    * **100%** - Close entire position
    * **Custom** - Enter exact share amount

    <Tip>
      Partial sells let you lock in profits while maintaining exposure. Sell 50% at profit to secure gains, let the rest ride.
    </Tip>
  </Step>

  <Step title="Review and Execute">
    Check the details:

    * Shares being sold
    * Current price
    * Estimated proceeds (after fee)
    * P\&L on this sale

    Click **Execute** to sell.
  </Step>
</Steps>

## Trading Strategies

<AccordionGroup>
  <Accordion title="Scalping (Quick Profits)">
    Buy and sell quickly based on short-term price movements.

    **Best Practices:**

    * Use market orders for instant execution
    * Trade liquid markets with tight spreads
    * Set clear profit targets (5-10%)
    * Watch for news that moves prices
    * Use smaller position sizes for multiple trades

    <Tip>
      Scalping works best on high-volume markets with frequent price updates. Check the 24h volume before trading.
    </Tip>
  </Accordion>

  <Accordion title="Value Trading (Long-Term Holds)">
    Identify mispriced markets and hold until resolution.

    **Best Practices:**

    * Deep research on event fundamentals
    * Use limit orders to get better entry prices
    * Larger position sizes on high-conviction trades
    * Hold through volatility
    * Calculate expected value before entering

    <Info>
      If you believe the true probability is 70% but the market is at 60%, you have a +10% edge. These add up over many trades.
    </Info>
  </Accordion>

  <Accordion title="Arbitrage (Risk-Free Profits)">
    Find markets where YES + NO prices don't equal \$1.00.

    **Example:**

    * YES trading at \$0.52
    * NO trading at \$0.46
    * Total: 0.98 (should be 1.00)
    * Profit opportunity: \$0.02 per share

    **Best Practices:**

    * Act quickly, these opportunities disappear fast
    * Use market orders for immediate execution
    * Account for fees (1% each side)
    * Works best with larger amounts

    <Warning>
      Arbitrage opportunities are rare and competitive. By the time you see them, they may already be gone.
    </Warning>
  </Accordion>

  <Accordion title="Hedging (Risk Management)">
    Use opposite positions to reduce risk.

    **Example:**

    * You're long YES at \$0.60 with 100 shares
    * Market moves to \$0.75
    * Sell 50 shares at \$0.75 to lock in profits
    * Keep 50 shares exposed for upside

    **Benefits:**

    * Lock in partial profits
    * Reduce downside risk
    * Stay in the game with remaining shares

    <Tip>
      Hedging is great when you have unrealized profits but think volatility might increase. Secure some gains while staying exposed.
    </Tip>
  </Accordion>
</AccordionGroup>

## Slippage Protection

Onsight automatically calculates slippage for market orders and warns you when it exceeds 5%.

### What is Slippage?

Slippage is the difference between expected price and actual execution price:

* **Low Volume Markets** - Larger slippage due to thin order books
* **Large Orders** - More slippage as you consume multiple price levels
* **High Volatility** - Prices change rapidly, affecting execution

```txt Slippage Example theme={null}
Example: Buying $100 worth at $0.65

Order Book:
10 shares at $0.650
20 shares at $0.655
30 shares at $0.660
40 shares at $0.670

Your order fills:
- 10 shares at $0.650 = $6.50
- 20 shares at $0.655 = $13.10
- 69 shares at $0.660 = $45.54
- 43 shares at $0.670 = $28.81

Average price: $0.658 (vs expected $0.650)
Slippage: +1.2%
```

<Warning>
  If slippage exceeds **10%**, you'll see a warning message:

  **HIGH SLIPPAGE: +10.2%**

  Your order may execute at a worse price than expected. Consider using a smaller amount or placing a limit order.
</Warning>

## Best Practices

<CardGroup cols="2">
  <Card icon="seedling" title="Start Small">
    Make your first few trades with minimum amounts (\$5-10) to learn the interface before committing larger amounts.
  </Card>

  <Card icon="chart-simple" title="Check Volume">
    High volume markets have tighter spreads and better liquidity. Look for markets with \$10K+ daily volume.
  </Card>

  <Card icon="gauge" title="Set Limits">
    Use limit orders for large trades to avoid slippage. Save 2-5% on execution vs market orders.
  </Card>

  <Card icon="clipboard-check" title="Track Performance">
    Review your **Positions** regularly. Know your P\&L on each trade and overall portfolio ROI.
  </Card>
</CardGroup>

<Note>
  Trading prediction markets involves risk. Only trade amounts you can afford to lose, and always do your own research before entering a position.
</Note>