# volkol.bot

**We read, organize, and act on what's already yours.**

Multi-tenant SaaS platform for crypto trading communities. Automates the VIP-access lifecycle on Telegram: payments, member volume tracking, TradingView indicator unlocks, content delivery, and trade alerts. Built so a community owner doesn't manually grant or revoke anything.

## Status

Active platform in production. Multiple paid KOL communities live, 100+ traders connected and tracked via exchange API integrations. Real traffic, real payments, real channel automations daily.

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

## Security model

- Exchange API credentials are read-only
- Payments routed through Telegram's CryptoBot, the 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

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.

## Contact

Telegram: @volkolbotsupport