> ## 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.

# FAQ & Troubleshooting

> Frequently asked questions and solutions to common issues

## General Questions

<AccordionGroup>
  <Accordion title="What is Onsight?">
    Onsight is a Telegram bot where you can trade  Polymarket events directly from your messaging app. No browser needed - execute trades, manage positions, and track performance all within Telegram.

    **Key Features:**

    * Instant market and limit orders
    * Secure wallet creation (Polygon Safe)
    * Gasless trading and withdrawals
    * Real-time portfolio tracking
    * Cross-chain token swaps
  </Accordion>

  <Accordion title="What is Polymarket?">
    Polymarket is the world's largest prediction market platform where you can trade on the outcomes of real-world events:

    * Politics (elections, legislation)
    * Sports (games, championships)
    * Crypto (price predictions, protocol events)
    * Business (earnings, product launches)
    * Science & Tech (AI, space, innovation)

    Shares are priced 0.00-1.00 representing probability. Winning shares pay \$1.00 at resolution.
  </Accordion>

  <Accordion title="How much does Onsight cost?">
    Using Onsight is completely free. Pay only when you trade!

    **Trading Fee:** 1% on executed trade volume (included in total amount)

    **Gasless Transactions:** All trading and withdrawals are gasless - no MATIC needed

    **Example:** \$100 trade = \$99 to market + \$1 fee. Simple and transparent.
  </Accordion>

  <Accordion title="Is Onsight secure?">
    Yes. Onsight employs multiple security layers:

    * **Encryption:** All private keys encrypted with AES-256
    * **Safe Wallets:** Polygon wallets use Gnosis Safe (institutional-grade)
    * **No Custody:** You maintain full control, export keys anytime
    * **Gasless Security:** Transactions via Polymarket's trusted relayer
    * **Code Audited:** Open source with security best practices

    <Tip>
      For maximum security, export and backup your private keys in a safe place. Don't rely solely on Onsight for access.
    </Tip>
  </Accordion>

  <Accordion title="Can I lose money trading?">
    Yes. Prediction market trading involves risk:

    * Prices are volatile and can change rapidly
    * Events may not resolve as expected
    * You can lose your entire investment on a trade
    * Past performance doesn't predict future results

    **Risk Management:**

    * Only invest what you can afford to lose
    * Diversify across multiple markets
    * Use stop-losses and profit targets
    * Start small to learn before scaling up

    <Warning>
      Never invest money you need for living expenses. Treat prediction market trading as speculative and high-risk. No advice should be taken as financial advice.
    </Warning>
  </Accordion>

  <Accordion title="How do I make money on prediction markets?">
    Profit when your prediction is correct:

    **Example:**

    * Buy 100 YES shares at a cost basis of \$0.60 per share = \$60.00 cost.
    * Event resolves YES
    * Receive \$100 payout (100 shares x \$1.00)
    * Profit: \$40 (67% ROI)

    **Strategies:**

    * **Scalping:** Quick trades on price movements
    * **Value trading:** Long-term holds on mispriced markets
    * **Arbitrage:** Exploit pricing inefficiencies
    * **News trading:** React to new information quickly

    <Warning>
      Success on prediction markets requires research, discipline, and risk management.
    </Warning>
  </Accordion>
</AccordionGroup>

## Getting Started

<AccordionGroup>
  <Accordion title="How do I create an account?">
    Getting started on Onsight is easy.

    1. Open Telegram
    2. Search `@PolysightBot`
    3. Click `/start`
    4. Wallets created automatically in 5 seconds

    No registration forms, no email verification, no KYC. Your Telegram  IS your Onsight account.
  </Accordion>

  <Accordion title="What wallets does Onsight create?">
    A Polygon Safe wallet and EOA wallet is automatically created:

    **Polygon Safe Wallet:**

    * For trading on Polymarket
    * Gnosis Safe for enhanced security
    * Controlled by your EOA key
    * Compatible with MetaMask + Safe interface

    Both wallets are yours forever - export keys anytime.
  </Accordion>

  <Accordion title="How do I fund my account?">
    Send any supported currency to the corresponding deposit address.

    **Option 1: Direct Transfer**

    * From exchange (Binance, Coinbase, etc.)
    * From MetaMask or other wallet

    **Option 2: On-Ramp**

    * Use Moonpay, Transak, or similar
    * Buy USDC directly on Polygon network
    * Send to your Onsight wallet address

    <Tip>
      Always verify  deposit chain and currency before sending. Each supported chain has a different deposit address. Lost funds cannot be recovered.
    </Tip>
  </Accordion>

  <Accordion title="What's the minimum deposit?">
    **Minimum trade:** \$2.00 USDC

    **Recommended starting balance:** \$25

    This allows for:

    * Multiple trades to learn the platform
    * Covering 1% fees on several trades
    * Room for experimentation
    * Small losses without running out

    No maximum deposit limit.
  </Accordion>

  <Accordion title="How long does wallet setup take?">
    **Wallet creation:** 3-5 seconds

    **Token approvals:** \~30 seconds (background)

    **Ready to trade:** As soon as you fund your wallet

    The bot will show a welcome message when setup completes. Click Continue to view your wallet addresses.
  </Accordion>
</AccordionGroup>

## Trading Questions

<AccordionGroup>
  <Accordion title="What's the difference between market and limit orders?">
    <Tabs>
      <Tab title="Market Orders">
        **Instant execution** at best available price

        **Pros:**

        * Executes immediately
        * Guaranteed to fill
        * Perfect for fast-moving markets

        **Cons:**

        * May have slippage
        * Pay current market price
        * Less control over execution price

        **Best for:** Smaller trades, urgent execution, high liquidity markets
      </Tab>

      <Tab title="Limit Orders">
        \*\*Set your price\*\*, wait for match

        **Pros:**

        * Control exact execution price
        * Better pricing than market
        * No slippage

        **Cons:**

        * May not fill
        * Requires patience
        * Minimum 5 shares required

        **Best for:** Larger trades, patient traders, illiquid markets
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Why did my limit order not fill?">
    Common reasons:

    **Price never reached:**

    * Market moved away from your limit price
    * Set price too far from current price
    * Low volume preventing price movement

    **Insufficient liquidity:**

    * Not enough matching orders on other side
    * Market volume too low
    * Your order size too large for available liquidity

    **Order expired:**

    * Reached expiration time without filling
    * Auto-cancelled and funds returned

    **Solutions:**

    * Move limit price closer to market
    * Use smaller order sizes
    * Extend expiration or use GTC
    * Consider market order for guaranteed fill
  </Accordion>

  <Accordion title="What is slippage and how do I avoid it?">
    **Slippage** = difference between expected and actual execution price

    **Causes:**

    * Low liquidity markets
    * Large order sizes
    * High volatility
    * Fast-moving prices

    **How to minimize:**

    * Trade high-volume markets (> \$10K daily volume)
    * Use smaller position sizes
    * Use limit orders instead of market orders
    * Trade during liquid hours (US business hours)
    * Split large orders into smaller pieces

    <Info>
      Onsight warns you if slippage exceeds 10%. When you see the warning, consider reducing size or using a limit order.
    </Info>
  </Accordion>

  <Accordion title="Can I cancel a trade after executing?">
    **Market orders:** No - execute instantly, cannot cancel

    **Limit orders (live):** Yes - cancel anytime before matching

    **Limit orders (filled):** No - already executed, becomes position

    To cancel live limit order:

    1. Go to **Orders**
    2. Find the live order
    3. Click **Cancel Order**
    4. Funds returned immediately

    <Note>
      Once an order matches (fully or partially), that portion cannot be cancelled. Only unmatched portion can be cancelled.
    </Note>
  </Accordion>

  <Accordion title="How do I know if my trade executed?">
    **Market orders:** Confirmation message immediately shows:

    * Order ID
    * Shares received
    * Execution price
    * Fee paid

    **Limit orders:** Status updates when:

    * **Live** - Waiting in order book
    * **Partially filled** - Some shares matched
    * **Filled** - Completely matched
    * **Cancelled** - Manually cancelled or expired

    Check **Orders** anytime to see all order statuses and history.

    <Tip>
      Save order IDs for record-keeping. You can verify on Polymarket's website using the order ID.
    </Tip>
  </Accordion>
</AccordionGroup>

## Wallet & Funds

<AccordionGroup>
  <Accordion title="How do I withdraw my funds?">
    Easy and gasless:

    1. Go to **Wallets** → **Withdraw**
    2. Enter destination address
    3. Enter amount
    4. Confirm withdrawal
    5. Funds arrive in \~30 seconds

    **No gas fees** - completely free withdrawals via Polymarket relayer.

    <Warning>
      Verify destination address carefully. Wrong address = permanent loss. Send small test amount first if unsure.
    </Warning>
  </Accordion>

  <Accordion title="Can I export my private keys?">
    Yes! You maintain full control of your wallet at all times:

    1. Go to **Wallets** → **Export Keys**
    2. Confirm security warnings
    3. Copy key to clipboard
    4. Import to MetaMask, Phantom, etc.

    **Important:**

    * Delete the message after copying
    * Never share your key with anyone
    * Store securely (paper wallet, hardware wallet)
    * Can continue using Polysight after exporting

    <Tip>
      Export and backup your keys even if you plan to keep using Onsight. Provides recovery option if you lose Telegram access.
    </Tip>
  </Accordion>

  <Accordion title="What if I lose access to my Telegram account?">
    If you exported and backed up your private keys: **Your funds are safe** - import keys to MetaMask/Phantom

    If you didn't export your keys: **Funds may be inaccessible** - recovery depends on:

    * Getting Telegram account back
    * Contact Telegram support for account recovery
    * Onsight cannot access your keys (they're encrypted)

    **Prevention:**

    1. Enable 2FA on Telegram
    2. Export and backup your private keys
    3. Store backup in safe place
    4. Test recovery process with small amount

    <Warning>
      Always export and backup your keys! Don't rely solely on Telegram access. Backup = peace of mind.
    </Warning>
  </Accordion>

  <Accordion title="Why is my balance different from what I expected?">
    Common reasons:

    **Funds locked in positions:**

    * USDC.e used to buy shares
    * Check **Positions** for open positions
    * Sell positions to free up USDC.e

    **Funds locked in limit orders:**

    * Buy orders lock USDC.e until filled/cancelled
    * Check **Orders** for pending orders
    * Cancel orders to return funds

    **Fees deducted:**

    * 1% fee on each trade
    * Check trade confirmations for fee amounts

    **Need balance refresh:**

    * Click **↻ Refresh** on home screen
    * Balances cached for 30 seconds
    * Refresh forces fresh data fetch

    <Tip>
      Your net worth = tradable balance + position values + locked order funds. Check Financial Overview on home screen for complete picture.
    </Tip>
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Bot is not responding">
    **Quick fixes:**

    1. **Wait 10 seconds** - Bot may be processing
    2. **Send /start** - Resets session
    3. **Click  Home** - Returns to main menu
    4. **Restart Telegram** - Clears local cache

    **If still not working:**

    * Check Telegram service status
    * Try on different device
    * Wait 15-30 minutes and try again
    * Bot may be under maintenance

    <Info>
      Onsight handles thousands of users. Occasional delays during high traffic are normal. Your funds are always safe.
    </Info>
  </Accordion>

  <Accordion title="Trade failed / Error executing order">
    **Common causes:**

    **Insufficient balance:**

    * Not enough USDC.e for trade + fee
    * Funds locked in positions/orders
    * Solution: Free up funds or reduce trade size

    **Minimum requirements:**

    * Trade must be at least \$2.00
    * Must result in at least 5 shares
    * Solution: Increase trade amount

    **Market moved:**

    * Price changed significantly since you started
    * Order book depleted
    * Solution: Reload market and try again

    **Network issues:**

    * Polymarket API temporarily down
    * Relayer congestion
    * Solution: Wait 1-2 minutes and retry

    <Tip>
      If error persists after 3 attempts, try a different market or wait 30 minutes. Save the error message if you need support.
    </Tip>
  </Accordion>

  <Accordion title="Cannot see my position after buying">
    **Possible reasons:**

    **Limit order not filled yet:**

    * Check **Orders** for live orders
    * Order status shows "live" not "filled"
    * Wait for match or cancel and use market order

    **Position value too small:**

    * Very small positions may not display
    * Check on Polymarket website directly
    * Use your wallet address to view

    **Data needs refresh:**

    * Click **↻ Refresh** on home screen
    * Wait 5 seconds for data update
    * Position should appear

    **Order failed:**

    * Check **Orders** history
    * Look for failure message
    * Funds returned to balance if failed

    <Note>
      Market order positions appear within 5 seconds. Limit order positions appear only after order fills.
    </Note>
  </Accordion>

  <Accordion title="Withdrawal not arriving">
    **Check these first:**

    1. **Transaction hash** - Check on PolygonScan
       * Confirmed? Funds left your wallet
       * Pending? Wait for confirmation
       * Failed? Funds returned to your Onsight wallet
    2. **Destination wallet**
       * Correct network? (Polygon not Ethereum mainnet)
       * Correct address? (0x... format)
       * Exchange requires confirmations? (5-20 min wait)
    3. **Amount**
       * Meets destination minimum? (exchanges have minimums)
       * Correct token? (USDC.e vs native USDC)

    **Recovery:**

    * If sent to wrong network: May be recoverable, contact destination support
    * If sent to wrong address: Likely permanent loss
    * If never left wallet: Transaction failed, funds still in wallet

    <Warning>
      Always verify address before withdrawing. Send small test amount first (\$5-10) to new destination addresses.
    </Warning>
  </Accordion>

  <Accordion title="Prices seem wrong or outdated">
    **Reasons:**

    **Cache delay:**

    * Prices cached for speed
    * May be 5-10 seconds old
    * Click **Reload** on market page

    **Low liquidity:**

    * Bid-ask spread wide
    * Few recent trades
    * Prices may look unusual
    * Check 24h volume (\< \$1K = illiquid)

    **Market moved:**

    * Fast-moving event
    * Major news just broke
    * Prices updating rapidly
    * Reload for latest

    **Compare to Polymarket:**

    * Check Polymarket website directly
    * Use your market link
    * Onsight prices should match within seconds

    <Tip>
      For fast-moving markets, reload frequently. Prices update in real-time but may have 5-10 second display delay.
    </Tip>
  </Accordion>

  <Accordion title="My question isn't answered here">
    **Get help:**

    1. **Check documentation:**
       * Read relevant guide sections
       * Search for keywords
       * Review examples
    2. **Try the bot's help:**
       * Click **Settings** icon ⚙️
       * Click **Support** button
    3. **Contact support:**
       * Telegram support channel
       * GitHub issues (for bugs)
    4. **Community:**
       * Join Discord group
       * Ask experienced users
       * Share strategies and tips

    <Note>
      When asking for help, include:

      * What you were trying to do
      * What happened instead
      * Error messages (exact text)
      * Screenshots (hide sensitive info)
      * Your Telegram username (for follow-up)
    </Note>
  </Accordion>
</AccordionGroup>

## Security & Safety

<AccordionGroup>
  <Accordion title="How do I protect my account?">
    **Essential security steps:**

    1. **Enable 2FA on Telegram**
       * Settings → Privacy and Security → Two-Step Verification
       * Strong password + recovery email
    2. **Export and backup keys**
       * **Wallets** → **Export Keys**
       * Write on paper, store in safe
       * Never save digitally unencrypted
    3. **Beware of phishing**
       * Never share private keys
       * Don't click suspicious links
       * Verify bot username exactly
       * Support never asks for keys
    4. **Secure your device**
       * Password/biometric lock
       * Don't root/jailbreak
       * Keep Telegram updated
       * Use trusted networks only
    5. **Start small**
       * Test with minimal amounts
       * Learn before scaling up
       * Don't deposit life savings

    <Warning>
      Your security is your responsibility. Onsight provides tools, but you must use them correctly. Backup keys and enable 2FA today!
    </Warning>
  </Accordion>

  <Accordion title="What if someone gets my private key?">
    **Immediate actions:**

    1. **Create new wallet immediately**
       * Stop using compromised wallet
       * Start fresh with new account
    2. **Move remaining funds**
       * Transfer to new wallet ASAP
       * Use different device if possible
       * Assume compromised wallet is empty
    3. **Analyze what happened**
       * How did they get your key?
       * Phishing? Malware? Physical access?
       * Fix the root cause
    4. **Change passwords**
       * Telegram
       * Email
       * Anything connected to device
    5. **Monitor addresses**
       * Watch old wallet on PolygonScan
       * Set alerts for transactions
       * Document theft for reporting

    **Prevention better than cure:**

    * Never share keys with anyone
    * Don't save in cloud/messages
    * Use hardware wallets for large amounts
    * Keep devices secure

    <Warning>
      Compromised keys cannot be "fixed" - funds are at risk. Create new wallet immediately and move any remaining funds.
    </Warning>
  </Accordion>

  <Accordion title="How do I spot scams and phishing?">
    **Common scams:**

    **Fake support:**

    * Claims to be Onsight team
    * Asks for private keys
    * Requests "verification" payment
    * **Real support NEVER asks for keys**

    **Impersonator bots:**

    * Similar username, different bot
    * Phishing for credentials
    * **Verify exact bot username**

    **"Free money" offers:**

    * Airdrops requiring key import
    * "Exclusive" trading signals
    * Guaranteed profit systems
    * **If too good to be true, it is**

    **Malicious markets:**

    * Fake Polymarket links
    * Markets that can't resolve
    * Obvious outcomes claimed uncertain
    * **Research markets before trading**

    **How to verify:**

    * Check bot username exactly
    * Verify official links
    * Research unknown markets
    * Never rush decisions
    * Ask community if unsure

    <Tip>
      When in doubt, DON'T. Better to miss opportunity than lose funds to scam. Take time to verify everything.
    </Tip>
  </Accordion>
</AccordionGroup>

<Note>
  Still have questions? Check the other guide sections for detailed information on specific topics, or reach out to support for personalized assistance.
</Note>