PO_SSID

🦉 AthenaAI is an AI-powered ensemble machine-learning trading bot for PocketOption, built on BinaryOptionsToolsV2 → Get it on GitLab
💬 Need help? Join the Chipa Discord · ⚡ Go no-code with ChipaEditor

Your PocketOption session ID. It is the only required environment variable: without it the bot refuses to start.

What it does

build_config() reads PO_SSID with an empty-string default and stores it in BotConfig.ssid. Immediately after building the config, main() checks if not config.ssid: — if the value is empty or unset, it prints an error to stderr explaining how to set the variable and exits with return code 1. No connection is attempted.

If set, the value is passed verbatim to the PocketOption client in src/bot.py (AITradingBot.start()):

self.client = PocketOptionAsync(ssid=self.cfg.ssid)

The bot then sleeps 3 seconds to allow the WebSocket handshake and fetches your account balance. An invalid or expired session ID typically surfaces here as a connection or balance failure, not at config time — the bot only validates that the value is non-empty.

The session ID is a secret. It never appears in source code; keep it in your environment or .env file only. Note that .env values are applied with setdefault, so a PO_SSID already present in your shell environment overrides the .env file.

Valid values

Any non-empty string. Obtain your session ID from an authenticated PocketOption browser session (it is the SSID your browser sends over the platform WebSocket).

Examples

export PO_SSID='your-session-id'

$env:PO_SSID = 'your-session-id'

# .env
PO_SSID=your_session_id_here

Interactions

• Every live action — balance query, candle streaming (PO_ASSET, PO_TIMEFRAME), and trade placement — runs over the session this ID authenticates.
• Dataset pre-training (PO_DATASET) happens before the connection, but the bot still exits early if PO_SSID is missing, so pre-training never runs without it.

See also

• Quickstart
• Configuration guide
• Live trading guide
• All environment variables

💬 Unsure how this interacts with the rest of the configuration? Ask in the Chipa Discord — or prototype strategies no-code with ChipaEditor.