Overview
AuctionLite makes it easy to use the auction house!
- Buy
- Show all listings for an item on a single page, sorted by per-item price
- Buy out multiple listings at the same time
- Search for your favorite items with a single click
- Sell
- Suggest prices based on the current competition
- Create multiple listings at the same time
- Scan
- Download all auction house data in just seconds
- Track historical prices and find deals
- Tooltips
- Show vendor, auction, and disenchant prices on all items
In short, AuctionLite tries to make the most common auction house tasks as simple as possible, and AuctionLite strives for minimal overhead and clutter in its interface.
Quick Start
Buying items: Type an item name into the "Buy" tab and click "Search". (You don't have to fill in a quantity.) Select the listings you want to buy, click "Buyout", and then click "Approve".
- Control-right-click an item in your bags from any AH tab to search on the "Buy" tab
- Use shift-click and control-click to select and purchase multiple listings
Selling items: Drag an item from your bags into the "Sell" tab slot. Enter the number and size of the stacks you'd like to sell, adjust prices if necessary, and click "Create Auction".
- Alt-right-click an item in your bags from any AH tab to load it into the "Sell" tab
- Click on any competing auction to undercut that auction
- Use the tab key to jump between fields
- Hit enter to start the auction
Scanning: Click "Full Scan" on the "Buy" tab. When scanning is complete, you'll get a list of the best deals currently available at the auction house.
- If you navigate away from the deals page, use "Show Deals" in the "Advanced" menu to return
- If you are disconnected during scanning, try disabling the fast scan feature (use "/al config")
Other features:
- To search for your own listings (and your competition), choose "Show My Auctions" from the "Advanced" menu
- Click the checkmark next to any item in the "Buy" tab to mark it as a favorite, and then select "Show Favorites" from the "Advanced" menu to search for all your favorites at once
- Go straight to your preferred tab when opening the AH
- Open all your bags when visiting the AH
For more details, read on!
Buying Items
To buy an item with AuctionLite, type the name of the item you want into the "Buy" tab and click "Search" (or control-right-click an item in your bags).
If your search returns only one kind of item, you'll see a list of all auctions for that item, sorted by the per-item buyout price (or per-item bid price, if no buyout price is available). Your own auctions are shown in yellow, and auctions where you are the highest bidder will show the bid price in yellow. If you want to bid or buy out a listing, click on it, click "Bid" or "Buyout", and then approve the purchase. You can select multiple auctions by control-clicking or shift-clicking.
If your search returns multiple items, you'll see a summary of the kinds of items that your search encountered. Click on any of these summary lines to see all listings for that item, as described above. To get back to the summary page, click the arrow button in the upper-left corner of the frame.
If you know exactly how many items you want to buy, type the number into the "Quantity" field when searching. AuctionLite will then offer to fill your order by selecting the auction listings that minimize the total cost to you. AuctionLite is smart enough to find the absolute minimal cost in most cases, including cases where you can buy more items to get a lower total price. If you would like AuctionLite to consider the resale value of excess items when making this decision (e.g., you ask for 10 items, but you'd rather get 11 at 101g than 10 at 100g), then you can enable the "Consider Resale Value" option (use "/al config"). If AuctionLite suggests purchasing more items than you originally requested (for any reason), it will show you to the expected resale value of the excess items and the net cost of the items you requested.
AuctionLite will incorporate all of the price data that your searches return into its historical data. Thus, the prices for items you frequently purchase will always be up to date, even if you don't do full auction house scans.
Favorites
On the "Buy" tab's summary display, you can click on the checkmark to the left of any item to mark it as a favorite (click again to unmark). Then, you can choose "Show Favorites" in the "Advanced" menu to quickly search for all of your favorites. Your favorites will also get bumped to the top of the summary display in any future search.
Your Auctions
In order to see auctions that you're selling, choose "Show My Auctions" from the "Advanced" menu. AuctionLite will search for all your current auctions so that you can see your competition. On the summary screen, any items where you've been undercut will be shown with a red background.
If you'd like to cancel an auction, just click the item, select your listing(s), and click "Cancel". You can select and cancel multiple auctions by using shift-click and control-click.
Selling Items
To sell an item with AuctionLite, start by dragging the item into the box on the "Sell" tab (or by alt-right-clicking an item in your bags). AuctionLite will immediately scan for all competing auctions, and it will suggest an appropriate price for your auction. In addition to setting bid and buyout prices, you can also tell AuctionLite to post multiple stacks of a certain size.
AuctionLite will display a list of competing auctions so that you can verify the accuracy of AuctionLite's suggestions. Any listings shown in gray are listings that AuctionLite considered to be outliers--that is, listings with abnormally low prices. AuctionLite typically chooses a price that is just less than the lowest non-outlier price, since this price is a reasonable estimate of the market-clearing price. If you disagree with AuctionLite's estimate of the market-clearing price, you can click on any auction in the display to undercut it by a few percent. Listings shown in yellow are your own auctions; clicking on them will fill in the prices you set for those auctions.
AuctionLite also shows some historical data for your item in the chat window. Every time AuctionLite scans for an item, it will incorporate the latest prices into its historical data, weighted according to the frequency of its scans.
If you want to sell items quickly, you can use alt-right-click even on the "Browse" tab in order to move an item into the "Sell" tab. If you approve of AuctionLite's initial suggestions, hitting enter will post the auction immediately.
AuctionLite's pricing scheme can be customized in the AuctionLite options screen (Escape -> Interface -> Addons -> AuctionLite).
Scanning
You can tell AuctionLite to scan all listings in the auction house by clicking the "Full Scan" button on the "Buy" tab.
After all auction data has been retrieved, AuctionLite will analyze the data and record the current market prices for later use. AuctionLite will take into account how frequently and how recently you've scanned, so there's no need to worry about how often you scan. Note that if you cancel the scan by closing the auction house, no data will be recorded.
AuctionLite also stores all price data from your scans in the "Buy" and "Sell" tabs, so even if you don't scan frequently, the prices for items that you buy and sell will stay up to date.
Deals
After you've completed a full scan, AuctionLite will search for all items in the auction house that are underpriced relative to previous scans, and it will show you these items ranked by potential profit. If you navigate away from this screen, you can recall the list of deals from the last scan of your current AH visit by going to "Advanced" and clicking "Show Deals". To set the parameters for this search, go to the AuctionLite options screen (in the "Advanced" menu) and set the minimum profit and the minimum discount relative to previous prices.
AuctionLite adds a few lines to the bottom of each item tooltip in the game to show the vendor sell price, the expected disenchant value, and the estimated auction house value. The disenchant value is based on the current value of the disenchanted dust/essences/shards at the auction house.
By default, AuctionLite shows the value for the entire stack. However, if you'd like to see the per-item price instead of the per-stack price, just hold the shift key. If you'd like this to be the other way around (i.e., per-item prices normally, and per-stack prices when holding shift), this setting can be adjusted in the AuctionLite options screen (type "/al config").
If you'd rather not see AuctionLite's information in tooltips, they can be customized or disabled in the AuctionLite options screen (type "/al config"). You can set each line in the tooltip so that it always appears, never appears, or appears only if the applicable data is available (e.g., if we have an auction house price for that item).
External API
AuctionLite supports Tekkub's GetSellValue and GetAuctionBuyout interfaces, so any addon that uses these interfaces will automatically be able to retrieve price data from AuctionLite.
In addition to these standard interfaces, other addons that wish to use AuctionLite's data can use the following methods:
price = AuctionLite:GetVendorValue(link or id[, suffix])
price = AuctionLite:GetDisenchantValue(link or id[, suffix])
price = AuctionLite:GetAuctionValue(link or id[, suffix])
These methods return AuctionLite's vendor, disenchant, and auction prices, which are the same numbers you see in the tooltips. You can pass an item string, an item link, or an item ID, but note that if you pass an ID for an item that typically has a suffix (e.g., "of the Monkey"), then you need to provide the suffix as the second argument. AuctionLite doesn't track bid prices--just buyout prices.
Acknowledgments
Thanks to kolenka for contributing bug fixes and features, and thanks to the Curse/WowAce/WowInterface community for their bug reports and suggestions.
Many, many thanks to the folks who took the time to translate AuctionLite to other languages!
- French: Pettigrow
- German: nesta666, Farook, tholas1234
- Korean: eljei, kdw112, ohmytrance
- Chinese: tnt2ray, wowuicn, a9012456, s8095324
- Russian: Vampik
Version History
Changes in v1.2.1:
- Fixed bug in German translation.
- Added Russian translation.
Changes in v1.2.0:
- Specify one extra stack in the "Sell" tab to sell excess items as a smaller stack (e.g., if you have 50 items and you enter "3 stacks of 20", AL will create 2 stacks of 20 and 1 stack of 10)
- When the number of stacks to sell is changed, the size of the stacks will be adjusted if necessary (e.g., if you have 20 items and you specify 20 stacks, AL will set the size to 1 automatically)
- New options for customizing the default number/size of stacks
- Vendor data updated for WoW 3.1.1
- Miscellaneous bug fixes
Changes in v1.1.5:
Changes in v1.1.4:
- Fixed bug when sorting favorites that aren't currently in the AH
Changes in v1.1.3:
- Much smarter algorithm for choosing listings in "Buy" tab
- Buying/canceling the last listing for an item will take you to the summary view
Changes in v1.1.2:
- Recently sold items no longer appear in "Show My Auctions"
- All favorites appear in "Show Favorites", even if they're not currently in the AH
- Updates to German localization
Changes in v1.1.1:
- Number formatting fix in "Sell" tab
- Scanner bug fix
Changes in v1.1:
- Sortable columns
- Improvements in auction searching/purchasing
- Localized to French, German, Korean, and Chinese (many thanks to the translators listed above!)
Changes in v1.0.3:
- Better error messages in "Buy" frame
- Suppress stack-splitting dialog when shift-clicking in "Buy" frame
- Added tooltips to mailbox items
Changes in v1.0.2:
Changes in v1.0.1:
- Fixed money icon flicker in tooltip
- Fixed control/alt-right-click when not at auction house
- Shift-left-click now works on the "Buy" tab
Changes in v1.0:
- Implemented Tekkub's GetSellValue and GetAuctionBuyout
- Undercut auctions are shown in red in the "Show My Auctions" list
- Fixed some display bugs in tooltips
- Save your place in the "Buy" frame when going to/from summary view
- Allow zero buyouts (i.e., bid only)
- Don't undercut historical prices
- Miscellaneous config screen cleanup
Changes in v0.9.2:
- Fixed a tooltip bug
- Updated some vendor data entries
- Save latest scan summary until you log out
Changes in v0.9.1:
- Removed unneeded debug code
Changes in v0.9:
- Tooltips now show expected disenchant value
- Tooltips use money icons
- Better configuration options for tooltips
Changes in v0.8:
- You can cancel your own auctions by selecting them and clicking "Cancel" (use shift-click and control-click to select and cancel many auctions)
- See your own auctions and your competition by choosing "Show My Auctions" in the "Advanced" menu
Changes in v0.7:
- Fast scanning: Perform a full AH scan in seconds!
- Deals: Show profit opportunities after each scan
- Favorites: Mark your favorite items and search for them quickly
- Control-right-click jumps to "Buy" tab and searches
- Alt-right-click jumps to "Sell" tab and searches
- Jump to your preferred tab when opening the AH
- Open all bags when opening the AH
- Show time elapsed and time remaining on searches
- Options GUI is available in Blizzard's interface options panel
- Upgraded to Ace3
Changes in v0.6:
- Items with jewels/enchants are labeled with a "+"
- Add tooltips to merchant, buyback, and loot
- Allow vendor multiplier to be set for when selling an item with no history
- Compatible with AuctionMaster
- Yet more bug fixes and UI tweaks
Changes in v0.5:
- Select multiple items in the "Buy" tab with control/shift
- Toggle per-stack and per-item prices in tooltips with shift
- Add tooltips to item links
- Allow users to set undercut percentage
- Bug fixes and UI tweaks
Changes in v0.4:
- Added "Buy" tab for easily searching and buying out auctions
- Added alt-right-click shortcuts
- Remember custom prices within a given visit to the auction house
- Reuse previous auction prices by clicking on your own auctions in the display
- Added external API
- Numerous bug fixes and UI enhancements
Changes in v0.3:
- Prices can be specified as per-item or per-stack prices
- Undercut specific auctions by clicking on them in the "Competing Auctions" display
- Tooltips can be disabled if desired
- Preferences for duration and pricing method are now saved
- When absolutely no data is available, we use triple the vendor price
- Numerous bug fixes
Changes in v0.2:
- Added tooltips with vendor sell price and auction value
- Your own auctions are now shown in yellow in the "Competing Auctions" display
- Pricing algorithm will no longer undercut your own auctions
- Added warning when your buyout is less than the vendor price
- Fixed bugs in the auction scanner and the auction display
Changes in v0.1:
Initial version.
------------------------------------------------------------------------
r131 | merialkilrogg | 2009-05-22 03:22:32 +0000 (Fri, 22 May 2009) | 2 lines
Changed paths:
M /trunk/AuctionLite.lua
M /trunk/AuctionLite.toc
Bump version number to 1.2.1.
------------------------------------------------------------------------
r130 | merialkilrogg | 2009-05-22 03:18:02 +0000 (Fri, 22 May 2009) | 2 lines
Changed paths:
M /trunk/AuctionLite.toc
A /trunk/Locale/ruRU.lua
Added Russian translation.
------------------------------------------------------------------------
r129 | merialkilrogg | 2009-05-22 01:51:40 +0000 (Fri, 22 May 2009) | 3 lines
Changed paths:
M /trunk/Locale/deDE.lua
M /trunk/Locale/frFR.lua
Added new French translations.
Slight tweaks to German translations.
------------------------------------------------------------------------
r127 | merialkilrogg | 2009-05-06 09:01:01 +0000 (Wed, 06 May 2009) | 2 lines
Changed paths:
M /trunk/AuctionLite.lua
M /trunk/AuctionLite.toc
Bump version number to 1.2.0.
------------------------------------------------------------------------
r126 | merialkilrogg | 2009-05-06 08:23:03 +0000 (Wed, 06 May 2009) | 2 lines
Changed paths:
M /trunk/SellFrame.lua
Clear error bit when starting a new search.
------------------------------------------------------------------------
r125 | merialkilrogg | 2009-05-06 06:20:41 +0000 (Wed, 06 May 2009) | 2 lines
Changed paths:
M /trunk/Locale/deDE.lua
M /trunk/Locale/frFR.lua
M /trunk/Locale/koKR.lua
M /trunk/Locale/zhCN.lua
M /trunk/Locale/zhTW.lua
Misc localization updates.
------------------------------------------------------------------------
r124 | merialkilrogg | 2009-05-06 05:59:29 +0000 (Wed, 06 May 2009) | 4 lines
Changed paths:
M /trunk/AuctionLite.lua
M /trunk/BuyFrame.lua
M /trunk/Locale/enUS.lua
M /trunk/SellFrame.lua
M /trunk/SellFrame.xml
Implemented options for setting number/size of stacks.
Auto-adjust stack size when count is changed.
Expand AL options when opening options window from "Buy" tab.
------------------------------------------------------------------------
r123 | merialkilrogg | 2009-05-05 04:43:19 +0000 (Tue, 05 May 2009) | 2 lines
Changed paths:
M /trunk/CreateAuctions.lua
M /trunk/SellFrame.lua
Sell last stack even if smaller.
------------------------------------------------------------------------
r122 | merialkilrogg | 2009-05-04 04:52:14 +0000 (Mon, 04 May 2009) | 2 lines
Changed paths:
M /trunk/VendorData.lua
Updated vendor data for 3.1.1.
------------------------------------------------------------------------
r121 | merialkilrogg | 2009-04-28 07:40:41 +0000 (Tue, 28 Apr 2009) | 2 lines
Changed paths:
M /trunk/BuyFrame.lua
Fixed undercut detection and removed some dead code.
------------------------------------------------------------------------
r120 | merialkilrogg | 2009-04-18 06:36:37 +0000 (Sat, 18 Apr 2009) | 2 lines
Changed paths:
M /trunk/BuyFrame.lua
Fixed bug when closing AH with a purchase pending.
------------------------------------------------------------------------
