Getting Started

Prerequisites: Node.js 20+, Telegram API id/hash from my.telegram.org , and a Pindo API token with an approved sender id.

Install and configure


cd trading-algos/telegram-bot
npm install
cp .env.example .env
# Edit .env: TELEGRAM_*, TELEGRAM_CHANNELS, PINDO_*, NOTIFICATION_NUMBERS


npm run login          # interactive; writes TELEGRAM_SESSION_PATH

Verify channels (optional)


npm run verify         # list dialogs and resolve channel usernames

Build and start


npm run build
npm start              # or: pm2 start ecosystem.config.cjs

Health and status

Default bind 127.0.0.1:8081:

GET /health → { "status": "ok" }
GET /status → uptime, Telegram connected flag, per-channel cursors, counters

Run one process (pm2 fork, one instance). Multiple instances would need shared state. See Failure Modes.

Next steps

Architecture — poll loop and fan-out.
Configuration — full env table.
State & Logs — on-disk session and cursors.

Last updated on August 12, 2026

Overview Failure Modes