How it Works
Understand what happens behind the scenes when you place an Up or Down trade.
The Core Idea
Polyscout is designed to let you trade prediction markets directly inside Telegram while the backend handles all the complexity. This section breaks down how the system works end to end: from the wallet you receive at onboarding, to how trades move through Polymarket’s infrastructure, to how fees and referrals are handled behind the scenes.
The Foundation: Polygon and USDC.e
Polyscout operates on the Polygon network because Polymarket settles trades there. Every trade, payout, and fee is denominated in USDC.e, which is the bridged version of USDC commonly used across Polygon.
To fund your trading wallet, you need to send USDC.e on Polygon. If your funds live on another chain or exchange, you can bridge them using tools like:
Official Polygon Bridge: https://bridge.wallet.polygon.technology
LI.FI Bridge: https://www.lifi.io/
Polymarket’s help docs: https://help.polymarket.com
Once the USDC.e arrives, it is immediately available for trading inside Polyscout.
Wallet Creation and Control
When you start using the bot, Polyscout creates a dedicated trading wallet tied to your Telegram account. You do not need to set anything up manually.
This wallet lives on chain and is controlled by the backend so it can execute automated trades the moment you confirm them in Telegram. You remain the owner of the wallet, and you can look up every transaction on Polygonscan.
The bot stores the signing keys securely and uses them only to execute actions you approve through Telegram, such as placing trades or withdrawing referral rewards. This setup lets the system trade fast and reliably while keeping everything transparent on chain.
Telegram as the Trading Interface
Telegram is your front end. It handles:
Trade selection
Stake entry
Balance checks
Referral link access
Reward withdrawals
All your commands flow into Polyscout’s backend engine, which handles the rest. You do not interact directly with Polymarket or any blockchain interface. The bot does that on your behalf.
The Backend Engine and Real-Time Market Data
Once you communicate a trade to the bot, the backend steps in. It stays connected to Polymarket through a mix of APIs and websocket feeds so it can track markets in real time.
The backend uses:
Polymarket’s central limit order book (CLOB)
Their REST trading API for submitting orders
Websocket streams for constant odds and liquidity updates
Polymarket’s gasless relayer for on chain settlement
This live connection allows Polyscout to see the current order book, mid price, liquidity levels, and any changes happening in milliseconds. It means when you hit “Up” or “Down,” the order is built using the freshest market data available.
What Happens When You Place a Trade
Here is what happens behind the scenes from the moment you confirm a trade:
Step 1: The bot validates your balance
The backend checks your USDC.e balance in your trading wallet to make sure the stake is available.
Step 2: The engine pulls the latest odds
Using Polymarket’s websocket feed, the system fetches the exact price for the outcome you picked. This includes checking the best bid, best ask, and any expected slippage.
Step 3: The order is built
The backend constructs a valid CLOB order for the Polymarket market you chose. It includes the outcome (Up or Down), your stake, price parameters, and risk controls.
Step 4: The order is submitted
The order goes through Polymarket’s CLOB API and settles through their relayer system. The relayer makes the transaction gasless, so you do not pay gas fees for trading.
Step 5: Fills stream back
As Polymarket matches your order, fills are pushed back to Polyscout through the websocket feed. The bot updates your balance and position instantly.
Step 6: Settlement and payouts
When the market resolves, Polymarket settles the winning outcome on chain. Your wallet receives the resulting USDC.e and Polyscout records the profit so it can apply any fee or referral sharing.
Everything stays inside Polymarket’s settlement layer, so you can validate activity directly on Polygonscan.
Fees and How They Are Applied
Polyscout uses a performance-based fee model. It only charges a fee when you win a trade, and the fee is always one percent of the winning amount.
If your trade loses, no fee is applied.
When a trade wins, the one percent fee is automatically deducted from your payout. How that fee is split depends on whether you joined through a referral link. The fee stays the same for every trader, but the revenue split differs behind the scenes.
Referral Program and Reward Tracking
Every user gets a unique referral link. When someone signs up through your link, you start earning rewards from their winning trades.
Here is the breakdown:
Your referral earns you half of the trading fee collected from that user.
Since the trading fee is 1% of a winning amount, you get half of that, which is 0.5%.
Polyscout keeps the remaining 0.5%.
If a user joins without a referral link, Polyscout keeps the full one percent because there is no referrer to reward.
Your referral earnings accumulate in a separate reward balance tied to your user ID. You can check it through the /balance command and withdraw it at any time using /withdraw. The backend then sends your USDC.e to your wallet on Polygon through the relayer system.
This gives every user a way to earn passive income just by promoting the bot.
Transparency and Security
All trades, deposits, rewards, and withdrawals happen on the blockchain. You can verify everything by pasting your wallet address into Polygonscan.
Polyscout’s backend controls the wallets only for automated execution, but you always see exactly what is happening. The system relies entirely on Polymarket’s infrastructure for pricing data, order execution, and settlement, which keeps everything transparent and decentralized.
Last updated