Market Watcher

Note: this addon no longer works with the retail version of the game and is now Classic only.  Do not download the non-Classic version.

Purpose

Market Watcher is an addon that scans individual items or collection of items instead of the entire auction house at once.  It also (optionally) records many snapshots of the auction house for user specified items.  This allows the following unique features:

• Charting of historical price data
• Indicators that show which auctions have actually sold
• Ordered buyout per unit lists, even for items with many pages, which make finding the lowest buyouts and undercutting the competition very easy/fast
• Very quickly finding, canceling and reposting undercut auctions
• Price data that is seconds old instead of hours or days
• Finding craftable items that are not currently for sale and then crafting+selling them from within the auction house window

Instead of downloading one gigantic dump of the auction house, this addon does mini-scans of individual items and summarizes the data from all pages and lists the auctions in an ordered list from cheapest to expensive.  An alternative auctions list buyout window next to the scan summaries allows you to quickly find and buyout the cheapest items.

How to Use Market Watcher

Adding Items

Once you have installed Market Watcher, visit an auction house NPC and bring up the auction house window.

You will notice two new tabs: History, and Scan.

First, you need to specify which items you wish to “watch.” Click the History tab, then click Add.

The Add Item window appears. Enter the name of an item you wish the addon to track, or the item id of an item. This addon needs specific information about the items it scans to function correctly, so it will need to get this information by checking the auction house for it, your inventory, your trade skills, or by silently asking the server to bring up tooltip information about an item id. The item id can be obtained by visiting a WoW database website. Simply search for the item in question and get the number in the URL, i.e. “http://www.wowhead.com/?item=34057”

Once you have added your item, the edit item window appears. From here you can instruct the addon to record the scans of the item, how long to keep the scans, and whether to only record full stacks. Also, you may configure the addon to not display the scan results of items that do not meet certain criteria, such as if the item is too expensive (or cheap), or whether there are none for sale or not. This speeds daily shopping and allows you to easily notice when there are undervalued auctions, or if a market is ripe for your own auctions, or to hide uninteresting markets.

Scanning

Once you have input all the items you want to watch for, click the Scan tab, then click the Scan button. If you do not want to record this scan, then uncheck the “Record Scans” check box. There are a couple of reasons you may not wish to record a particular scan.

First, scans can use up a lot of memory. In fact there is currently no limit to the memory usage of this addon – it is possible to configure this addon to use as much memory as you tell it to, so you must pay some attention to this if you record scans for many items. The memory used by the addon is prominently displayed on the History tab. To give you a rough idea of how much memory scans might use, 500 or so individual item scans uses up about two megabytes of memory. If you configured the addon to record 50 items, then hitting the scan button with record scans checked will use roughly two megabytes of ram after 10 clicks of the scan button. It is also important to note, however, that some items will use far more memory than others. Frostweave cloth or Infinite Dust scans will use much, much more memory than say, Nobles Deck scans.

Secondly, the more uniform your scans are, the more accurate some of the addon estimates and calculations will be. Specifically the price change indicators in the scan summary and the technical analysis indicators.

Once the scan is complete, the scan summary is displayed. Here you can see at a glance how many units are for sale and the cheapest price per unit. If you input a threshold value when setting an item’s options, the price text will either be green or red depending if the item’s unit price is below or above that threshold value. If an item has scans saved, a percentile indicating the price change from the last week and the last month is displayed. This allows you to quickly determine if an item is selling above or below market value.

Mouseovering an item’s summary will bring up a tooltip that will list every auction of that item at the time of the scan, ordered by buyout price per unit. Clicking on an item’s summary will query the auction house for that item, and bring up the results on the right side of the window. From here you can conveniently make your purchases in a compact, price per unit ordered list. Shift + right clicking a result will buy that auction out instantly. Note that the auctions listed on the right side of the window are actual auction house results, and therefore have multiple pages, so you may need to click the arrows at the bottom to find the cheapest auction as indicated in the tooltip.

Alternatively you can scan items by right clicking categories on the Browse tab (enter a Name or level range to narrow the scope) or by alt+left clicking an item in your inventory on the Scan tab.

Reviewing Scan Data

Now that you have a scan saved, you can bring up the scan on the History tab. Click the History tab and then click on an item you have set to record. If you have three or more scans, a price history graph is displayed, otherwise a display similar to Blizzard’s auction house results page is displayed. You can switch between the two views by clicking the button at the bottom.

The list view will display the scan number and how long ago it was taken. To save space, auctions that are identical are merged and given a number in the # column. The number obviously being how many duplicates of this auction there were. Note that sometimes it will appear as if it did not merge every seemingly duplicate auction. That is because items have a hidden value associated with them. Blizzard uses this value to track certain details about items. (such as where they came from)

If scans are less than 12 hours apart, Market Watcher can deduce if any “Very Long” auctions have either been sold or removed by the seller. Likewise, if scans are under two hours apart, the addon can determine if a “Long” auction was sold or removed, and so on. Using some judgment, you can then determine which auctions are being bought out. If the top few auctions listed are labeled “Sold or Removed” then it’s safe to say they were bought out. Auctions with bids are also indicated. You can use this knowledge to more accurately gauge an item’s worth.

The graph display can visually represent an item’s change in price over time. “Low” “Average” and “High” are the lowest buyout price per unit, average buyout price per unit, and highest buyout price per unit of the auctions in the scan on that date. “Actual” is the actual price. “SMA” is the Simple Moving Average, which is the average of the last 10 price points. “EMA” is the Exponential Moving Average, which works similar to the Simple Moving Average, except more weight is put on the more recent prices. “Trend” shows the overall price trend (if the price is falling, rising, or flat) of all of the scans.

Warning to Users:

It is recommended that users routinely back up their saved scan data if they value this data, because in rare cases addon data has been known to be lost due to client bugs or some unknown cause.

The file with the data is located in this folder on your disk:

\World of Warcraft\<_classic_ or _retail_>\WTF\Account\<account name>\SavedVariables\MarketWatcher.lua