v0.6 alpha Discord companion for Path of Exile 2

PoE2Watch

Never wonder if your trade sold again.

A self-hosted bot for sale alerts, item cards, goals, diagnostics, and trade stats.

Run it on your own machine, get Discord pings when sales are detected, and keep a searchable local history of your trades while official GGG OAuth support remains pending.

  • v0.6 alpha
  • Docker supported
  • MIT licensed
  • Local first

Self-hosted. Open source. Read-only. No gameplay automation.

Features

Ping

Mobile Sale Pings

Get clean Discord notification text for meaningful sales while every sale still posts its full item card.

Card

Item Cards

See rarity-colored item cards with icons, requirements, corrupted states, and useful modifier detail.

Goal

Goals & Analytics

Track goals, top sales, recent history, league totals, insights, averages, and estimated Divine value.

Safe

Docker & Diagnostics

Use the hardened Docker path, startup checklist, and sanitized health export when setup needs help.

Setup Path

PoE2Watch is still self-hosted. The docs now walk new users through Discord setup, Docker or Node, and first-run checks.

Create Discord App

Make your own Discord bot application, invite it to your server, and create a webhook for sale posts.

Discord setup guide

Fill In .env

Add your bot token, server ID, webhook URL, PoE league, and local session cookie to the ignored config file.

Configuration guide

Choose Runtime

Run with Docker for isolation, or use local Node/npm if you want to edit and develop the project directly.

Installation guide

Check Health

Use /health view and /health export to confirm setup without exposing secrets.

Command guide

PoE2Watch Discord sale notification on a mobile lock screen

Built for the moment you step away

Sale pings that make sense on your phone.

PoE2Watch keeps the mobile notification simple: the item name, sale price, and Discord channel context. The detailed item card still lives in Discord when you open the message.

  • Clean lock-screen summary for quick checks.
  • Full item details stay in Discord for when you have time.
  • Works with mirrored webhook channels for proof-of-concept sharing.

Discord Commands

Commands are built around quick answers: what sold, how much it was worth, what goal it funded, and whether setup is healthy.

/last3 Recent item cards
PoE2Watch
Recent Sale 1 of 3
Apocalypse Spark Diamond5 Chaos
RarityRare
Estimate≈ 0.64 Divine
DetailsMods + icon
/goal Progress tracking
PoE2Watch
Trading Goals
Tracked Value≈ 640.4 Divine
1. New Build100%
2. Crafting Fund61%
PrioritySpillover
/health Setup diagnostics
PoE2Watch
PoE2Watch Health
Discord ConfigOK
SQLiteOK
Exchange CacheAvailable
ExportSanitized

Roadmap

v0.5.x

  • Complete: Trading Experience
  • Complete: Item Cards
  • Complete: Better Embeds
  • Complete: Goals
  • Complete: History Search
  • Complete: Docker Support

v0.6.x

  • Active: Self-Hosted Hardening
  • Added: Setup Walkthroughs
  • Added: Health Export
  • Added: Notification Thresholds
  • Added: CI and Tests
  • Next: Digest and More Coverage

v0.7.x

  • Planned: Website
  • Planned: Login
  • Planned: Web Dashboard
  • Planned: Public Stats
  • Planned: API

v1.0.0

  • Planned: PoE2Watch Cloud
  • Planned: Managed Bot
  • Pending: GGG OAuth
  • Planned: Cloud Dashboard