Stock Market Module¶
The Stock Market Module tracks the Torn stock market and sends alerts for price movements, all-time highs/lows, and large transactions - plus personal portfolio tracking and price alert configuration.
Guild Module
This module is configured per Discord server via Guild Configuration.
Overview¶
The Stock Market Module monitors all Torn stocks and fires alerts when configured thresholds are crossed. Alert types cover three categories: record highs and lows, notable price changes (spikes of 0.1%+ over 15/30/60 minutes), and buy/sell transactions above a configurable minimum value.
Large transaction alerts support three tiered ping roles (Small, Medium, Large) based on transaction size, allowing different members to opt in to different levels of activity.
Members can also set personal price alerts via /stock alerts, track their own portfolio via /portfolio, and look up stock block costs via /stock block.
Key Features¶
- Three alert categories: Lows & Highs, Price Changes, Buys & Sales
- Tiered transaction ping roles (Small $50–100b, Medium $100–250b, Large $250b+)
- Separate transactions channel (falls back to alerts channel if not set)
- Personal price alert configuration with optional max-alert limit
- Portfolio tracker linked to your Torn account
- Stock rankings ordered by market cap
- Stock block cost viewer
Commands¶
| Command | Description | Permission Required |
|---|---|---|
/stock alerts |
View and configure personal price point alerts | Registered User |
/stock ranks |
View all stocks ordered by rank | Registered User |
/stock roles |
Add or remove stock transaction ping roles | Registered User |
/stock block |
View the cost of a stock block by acronym | Registered User |
/portfolio |
View your personal stock portfolio | Registered User |
Prerequisites¶
- You must be a registered user (have a paired API key).
- Alerts Channel must be configured to receive automated alerts.
Configuration¶
This module is configured via the Guild Config - Stock Market Module page.
| Setting | Default | Summary |
|---|---|---|
| Selected Alerts | All |
Which alert categories are sent to the channel |
| Alerts Channel | null |
The text channel where stock alerts are sent |
| Transactions Channel | null |
Separate channel for transaction alerts (falls back to Alerts Channel) |
| Minimum Transaction | $100,000,000,000 |
Minimum transaction value to generate an alert |
| Small Transaction Ping Role | null |
Role pinged for transactions between $50b–$100b |
| Medium Transaction Ping Role | null |
Role pinged for transactions between $100b–$250b |
| Large Transaction Ping Role | null |
Role pinged for transactions over $250b |
Alert Types¶
| Alert | Description |
|---|---|
| Lows & Highs | Alerts for monthly, yearly, or all-time price records |
| Price Changes | Alerts for price spikes of 0.1%+ over 15, 30, or 60 minutes |
| Buys & Sales | Alerts for transactions above the configured minimum value |