🆓 Free Commands (available to everyone)
/price <item>
Get the current high and low prices of any OSRS item.
Displays the item name, price, and icon in a rich embed.
Includes last update time.
Example: /price Abyssal whip.
/favorite <item>
Add an item to your personal favorites list.
Favorites are stored per-user.
Displays a confirmation embed with the item icon.
/favorites
Show your saved favorites as a set of embeds.
Each embed shows the item icon, high price, and low price.
Supports up to 10 items at once.
/unfavorite <item>
Remove a specific item from your favorites.
/analyze <item> – Get a detailed breakdown of any item, including:
High & low prices
Margin & % spread
Short-term trend (rising, falling, stable)
Volatility over ~2 weeks
Flip potential hints
Free users can run this up to 15 times/day (configurable), Premium users get unlimited access!
/usage – Check how many /analyze requests you’ve used today, see your remaining limit, and when it resets.
Premium users will see that their usage is unlimited.
đź’Ž Premium Commands (subscriber-only)
Premium is handled natively through Discord’s SKU subscription system. Subscribed users (or manually granted users via admin commands) unlock the following commands:
/chart <item>
Render a historical price chart for the item.
Great for spotting trends.
Embed includes the chart + item thumbnail.
/compare <item1> <item2>
Compare two items side by side.
Shows highs, lows, and differences.
Handy for evaluating substitutes (e.g., whip vs tentacle).
/flip
Suggests flipping opportunities.
Lists items with attractive buy/sell margins.
Includes icons, highs/lows, and profit estimates.
/topmovers
Shows the day’s top moving items by percentage change.
Embeds include icons, highs/lows, and change %.
/threshold <item> <gp>
Set a personal notification threshold for an item.
Example: alert me if Dragon claws drop below 90m.
đź”’ Premium Gating
Premium commands are gated in two layers:
Webhook Entitlements: When a user subscribes, Discord fires an entitlement event. The bot assigns the premium role and updates its in-memory set.
Runtime Checks: Commands call ensurePremium(userId) to verify access. If the user is not premium, they receive a polite ephemeral message with a subscription link.
✨ Features Recap
Real-time price data from the RuneScape Wiki API.
Embeds with icons, prices, and charts (premium).
Personal favorites system stored per user.
Threshold alerts (premium) for when items cross target prices.
Admin tools for managing premium.
Fully integrated with Discord’s native subscription system.
⚔️ Whether you’re monitoring your flips, tracking your favorite gear, or just curious about today’s top movers, the OSRS Price Companion Bot makes RuneScape trading easier and more accessible — right from Discord.