Telegram Reference

Control and monitor your Artic agents from Telegram.

Setup

cd clients/telegram
pip install -r requirements.txt
python -m telegram

Per-chat sessions

Command	Usage	Description
`/start`	`/start`	Show welcome message and command list
`/register`	`/register` <email> <password>	Create account and auto-login
`/login`	`/login` <email> <password>	Authenticate existing account

Command	Usage	Description
`/agents`	`/agents`	List all agents with status and live PnL
`/agent`	`/agent` <id>	Full details — config + live status if running
`/status`	`/status` <id>	Live snapshot: side, price, entry, PnL, strategy, action
`/create`	`/create` <symbol> [amount] [leverage] [risk]	Create and launch agent
`/startbot`	`/startbot` <id>	Restart a stopped agent
`/stopbot`	`/stopbot` <id>	Stop a running agent
`/logs`	`/logs` <id>	Last 15 log entries with level icons
`/symbols`	`/symbols`	List all supported trading pairs

/create <symbol> [amount] [leverage] [risk]

Parameter	Default	Constraints
Symbol	required	Ticker (`BTC`) or pair (`BTCUSDT`). See `/symbols`
Amount	100	USDT, must be greater than 0
Leverage	5	1–125
Risk	moderate	`conservative`, `moderate`, `aggressive`

Examples:

/create BTC
/create ETH 200
/create SOL 500 10 aggressive

/edit <agent_id> <field> <value>

Field	Maps to	Type	Example
`amount`	`amount_usdt`	number	`/edit abc1 amount 500`
`leverage`	`leverage`	integer	`/edit abc1 leverage 10`
`tp`	`tp_pct`	decimal	`/edit abc1 tp 0.05` (= 5%)
`sl`	`sl_pct`	decimal	`/edit abc1 sl 0.02` (= 2%)
`risk`	`risk_profile`	string	`/edit abc1 risk aggressive`
`supervisor`	`supervisor_interval`	number	`/edit abc1 supervisor 120` (seconds)
`poll`	`poll_seconds`	number	`/edit abc1 poll 2`
`llm`	`llm_provider`	string	`/edit abc1 llm anthropic`
`name`	`name`	string	`/edit abc1 name "My Bot"`

Command	Usage	Description
`/leaderboard`	`/leaderboard`	Top 5 agents globally
`/optin`	`/optin` <id> [handle]	Join leaderboard with optional display name
`/optout`	`/optout` <id>	Remove agent from leaderboard

You don't need the full UUID — any unique prefix of 4+ characters works:

/status abc1        matches abc1a2b3-...
/stopbot 9f3e       matches 9f3e7d88-...

If the prefix matches multiple agents, the bot lists them so you can be more specific.