# volkol.bot **We read, organize, and act on what's already yours.** volkol.bot ships two distinct products on the same infrastructure: 1. **The KOL Platform** — multi-tenant SaaS that automates VIP-access lifecycles for crypto trading communities on Telegram (payments, member volume tracking, TradingView indicator unlocks, content delivery). 2. **Alert Access** (`@volkolalertbot`) — a standalone retail service that delivers real-time scale-in trade alerts on crypto perpetuals to individual traders, with a 24-hour free preview and paid tiers. Both run in production with real members, real payments, and real channel automations daily. --- ## Product 1: KOL Platform Active multi-tenant SaaS. Multiple paid KOL communities live, 100+ traders connected and tracked via exchange API integrations. ### What it does - Connects to exchange APIs (read-only) to track member trading volumes - Auto-grants and revokes Telegram channel access based on volume tiers - Auto-grants and revokes TradingView indicator access by volume or purchase - Handles paid access purchases via Telegram's CryptoBot - Real-time trade alerts to members when the community owner trades - Full white-label support: custom domain, bot username, brand colors - 4-language i18n (EN, ES, PT, DE) ### Where data and money actually live (no lock-in) The platform is a presentation and automation layer over data that already belongs to the community owner at primary sources: - **The Telegram channel and group** belong to the KOL. Volkol holds no ownership; if the platform vanished, the channel keeps running. - **The member list, member UIDs, registration dates, trading volumes, and affiliate commissions** live at the exchange's affiliate dashboard. Volkol reads from there with read-only credentials. The exchange is the canonical source. - **Member chat content and history** belong to Telegram, not the platform. The only data unique to volkol is configuration: tier rules, bot menu, product catalog, course/video setup. That is settings, not assets. A KOL departing the platform takes their channel, their exchange affiliate data, and their members with them by default. ### Funds flow The platform does not custody funds. Two distinct money streams: 1. **Exchange affiliate revenue (the KOL's main income).** Members trade on their connected exchange, the exchange pays the KOL their affiliate commission directly. This money never touches volkol.bot at any point. Volkol only reads volume figures from the exchange API. 2. **Member purchases of paid access or addons (the platform's revenue source).** A member pays the KOL through Telegram's CryptoBot. The platform routes 90% to the KOL's CryptoBot wallet on payment confirmation and retains 10% as the platform fee (30% on cross-community marketplace sales). The retained portion covers the KOL's monthly platform balance. Volkol does not sit on KOL-bound funds. For verification: payment custody is CryptoBot, not volkol. Exchange affiliate custody is the exchange, not volkol. The platform's only treasury is the running 10% fee on paid sales, which finances the platform's own operating costs. --- ## Product 2: Alert Access (@volkolalertbot) Standalone retail product at [volkol.bot/#/alerts](https://volkol.bot/#/alerts). Bot username `@volkolalertbot`. ### What it is Real-time trade-setup alerts on crypto perpetuals, delivered by Telegram bot to individual members. Each alert is a structured card showing entry zone, target, stop loss, structural context, and an AI-written thesis explaining the setup. ### Method Members are taught a single coherent trading method: - **Scale-in technique** as the default: up to 5 wide-spread entries sized 1% of account each (5% max exposure) with 20x leverage. - **Wait calmly** through drawdown; mean-reversion arrives in both directions. - **Stop-loss anchored past the deepest entry**, never inside the ladder. - **Asymmetric direction bias** by asset class: altcoin SHORTs and bluechip LONGs are the safer asymmetric edges; the other sides are mean-reversion only. Every alert card surfaces multi-day context the AI uses to size conviction: - 7-day and 14-day percent change - Consecutive same-direction daily-close streak count - Daily-timeframe RSI - Bull/bear price-RSI divergence at 1h, 4h, and 1d Bear divergence printed alongside a SHORT fire signals a correction is mathematically overdue. Symmetric for bull divergence + LONG. ### Tiers Four product tiers, all one-time time-limited Alert Access (not subscriptions, no auto-renewal): - **Free 24-hour preview** on first `/start` — full alert stream, no restrictions, expires automatically. - **Essential** ($49 / $99 / $199 for 1m / 3m / 1y) — simplified alert cards. - **Pro** ($99 / $149 / $299 for 1m / 3m / 1y) — full analytical cards with AI thesis, multi-timeframe context, structural ladder, and divergence cues. - **Free pass** — comp grants for active KOL crew members, periodically refreshed. ### Engine architecture - Tracks crypto perpetuals on Binance Futures + Bybit via WebSocket - 5-7 second alert pipeline from WebSocket tick to member Telegram - Pre-emission AI review via Claude Opus (180s budget, Sonnet fallback) writes the thesis and grounds entries against multi-timeframe Nadaraya-Watson bands - $5M minimum market-cap floor; dust filtered before dispatch - Post-fire outcome tracker on 6 horizons (15m / 1h / 4h / 24h / 48h / 72h) for system audits ### Languages EN, ES, PT, DE. Member picks language on signup; alert cards and bot UI localize automatically. ### Referrals Members earn refunds for referring friends to paid tiers. Member-side referrals: 1 USDT first-friend bonus plus 10% of every subsequent friend's purchase. KOL-side referrals: revenue share when a KOL's audience converts through their slug code. --- ## Security model - Exchange API credentials are read-only - Payments routed through Telegram's CryptoBot; platform never holds funds - TradingView access gated through TradingView's own permission system - Per-KOL credential isolation; no cross-tenant data sharing - 29,000+ lines of code, audited frequently ## Tech stack React SPA + Express backend, PostgreSQL, Telegram Web App SDK, asyncio Python bot. CryptoBot for payments. Live trade alert pipeline tracks exchange WebSocket feeds in real time. ## Status - KOL Platform: live in production, multiple paying communities - Alert Access: live in production at `@volkolalertbot`, scaling member base - Both products: 4-language support active, real members trading on alerts daily ## Contact Telegram: [@volkolbotsupport](https://t.me/volkolbotsupport)