Stash‐Ninja

Feature Overview

• overlays item-prices onto the grid of every fixed-structure stash tab

  • displays poe.ninja prices by default to help you find high/low-value items at a glance

  • lets you fetch current exchange-prices to help you list items at appropriate prices

• seamless switching between up to 5 customizable price-range filters

• optional: lets you bookmark specific (sets of) items that you frequently access

• optional: shows an item's price history

• optional: offers (bulk-)sale management to facilitate listing items

• press TAB while the overlay is active to toggle highlighting for currently-listed items

GeForce Now Differences

• the omni-key can't access clipboard data, so the feature is activated via a dedicated hotkey (default: F2)

  • pressing the hotkey will open a selection menu of the supported stash tabs
    

  • click an entry to open the overlay for a specific tab

• bulk-sale management can't read your stock, so it can't check if your listing is valid

Requirements

• the inventory pixel-check to be set up correctly in the screen-checks section of the settings menu

User Interface & Settings

• this feature has its own section in the settings menu, with UI and pricing settings

main UI-elements & user interaction	screenshot
profile panel (bottom): - press number-keys 1 to 5 to switch between the displayed profiles price-tags (across the grid): - hover over highlighted item-slots to see currency-equivalent prices
(bulk-)sale management: - click a currency icon to toggle the listings-table on the right - right-click an icon to refresh the listings-table - click a price-point in the table to load it into the panel - hover over the confirm-button and scroll to adjust stack-size - click confirm to paste the listing into the game
bookmarking: - hover over items and press SPACE to add 1x, or press ALT to remove 1x - hold CTRL or SHIFT, then press number-keys 1 to 5 to switch between bookmark-profiles - click copy regex to copy a regex-string for the bookmarked items into the clipboard (in-game exchange)

Initial Setup

• make sure your in-game stash has at least one stash-folder

  • the overlay's item-slot grid will be misaligned slightly if there aren't any folders

  • you can simply put a random tab (e.g. dump tab) into a folder

• open the settings menu by clicking the cogwheel-icon on the main toolbar

• select stash-ninja on the left, then click the enable-checkbox on the right

• within the game, open the tab you want to set up and long-press the omni-key (default: middle mouse-button) while hovering over an item in the tab

  • as soon as the overlay is active, the settings menu should detect which tab is active
    

  • if you want to use this features for tabs within a stash folder, you'll have to check the box shown below (the overlay has to be offset in order to align correctly)
    

  • fine-tune the gap value on the right until all the price-tags more or less align with the in-game stash

Setting Up Price-Range Limits

• near the bottom of the settings window, there are five groups of text-boxes
  

• the top-left box shows the profile-number (and hence the hotkey to activate the profile)

• the bot-left box specifies which values to show (C, E, D, %), i.e. chaos, exalt, divine, or last week's price-change

  • leaving this blank will disable the profile entirely

• the top-right box is used to set the max value for the price-range

  • setting a value x will highlight items up to x and filter out anything above

  • leaving this blank treats the max value as unlimited (basically 999999)

• the bot-right box is used to set the min value for the price-range

  • setting a value x will highlight items starting from x and filter out anything below

  • leaving this blank treats the min value as unlimited (basically 0, or -999 for %)

General Usage

• open a stash tab in game and then long-press the omni-key (default: middle mouse-button) while hovering over an item inside the stash

• the overlay will open and display the profile panel below the stash
  

  • if the tab is divided into sub-tabs, their selection-boxes will be highlighted by additional overlay-buttons
    

  • if you click a button to switch sub-tabs in game, the stash-ninja overlay will also switch accordingly

• it will automatically highlight items according to the most-recently selected profile (or #1 if opened for the first time in the current session)

• while the overlay is active, it will automatically adapt to mouse movement & actions (e.g. hide if it would otherwise block in-game text)

• while the overlay is active, press number-keys 1 to 5 to switch between profiles

• hovering over an item that is highlighted by the overlay will display a panel with currency-equivalent prices

  

• shift/right-clicking stacks to split/price them will temporarily hide the overlay until you press ENTER or ESC

  • it is important to avoid using the in-game cancel/confirm buttons when splitting/pricing

Bookmarking

• if the enable bookmarking setting is enabled for a specific tab, an additional panel will be displayed next to the price-profile panel

  • bookmarking can be used to highlight sets of items that you need to access frequently

  • it can also be used to create personal vendor-lists if you're not satisfied with poe.ninja prices

• hover over an item and press SPACE to add 1x to the bookmark-list, or press ALT to remove 1x

  • bookmarked items will always be highlighted in the stash, regardless of which price-profile is currently active

  • bookmarked items have a distinct color-pattern that can be customized in the settings menu

• you can use up to 5 individual lists per stash-tab: hold CTRL or SHIFT, then press number-keys 1-5 to switch

Bulk-Sale Management

• if the enable bulk-sale management setting is enabled, right-clicking an item in a tab while Stash-Ninja is active will open the panel

• when first right-clicking an item, the right-most column will show the stack's market value according to poe.ninja prices

  

• to list an item, you have to get live prices by clicking one of the icons:

  

  • whenever you fetch live prices, a median will be calculated and pre-selected as the new global price for that item (which will also be the price displayed on price tags in the general overlay)

  • this will also unlock the sell X for Y columns on the left and enter the corresponding stack-size and price values

• as with splitting stacks, it is very important to press <ESC> when cancelling/discarding, instead of clicking the in-game cancel button

  • if you accidentally cancel it via the in-game buttons, you can click the x button in the top-right

---

• clicking a currency icon will toggle a table on the right, showing what kind of listings are currently open on the exchange

  

  • this table can be closed by clicking the icon again or pressing ESC

• the first column shows current price-points on the exchange, and the currently-selected one is highlighted in green, while the current median price-point is highlighted with a yellow border

  • it's important to note that every row corresponds with a price-point, not a listed item (i.e. each row is a summary of every item listed at that price-point)

  • you can click any price-point to select it as the new global price and also apply it to the pricing panel on the left

• the second column shows the number of listings at each price-point (these are visualized by a bar underneath), and the header shows the total number of open listings

  • the idea is to visualize whether there are specific concentrations of listings around specific price-points

• T+XX:YY underneath the first two columns shows how much time has elapsed since fetching the price data

  • you can right-click the currency icons to fetch the latest price data

---

• the combined third/fourth columns are enabled by default but can be toggled by clicking the < / > button in the top-right

  • they show stock levels at a given price-point (both the overall stock and the highest stock held by a single seller), with bars underneath as visualization

  • the idea is to identify potential "price walls" where large amounts of stock have to be bought up first before the general market price can go any higher

  • the second stock-column can be used to identify how individuals with large stock are pricing their items and what kind of "bulk-tax" they take (if any)

---

• you can hover over the confirm-button or the X and Y values in the sell X for Y columns and scroll the mouse-wheel to adjust stack-size and final price according to the price-point

  • it will stop you from scrolling past your actual stock (except for unstackable edge-case items that don't show stack-size in the tooltip)

  • it will also stop you from scrolling past the point of a full inventory's worth of items in either the sell of for column

  • you can also press the middle mouse-button to reset the values to what they were at the beginning

• click confirm to paste the listing-string into the game's pricing UI

Rate-Limiting

• as you are probably aware, there are set limits on how often/quick you can perform requests to the servers

• bulk-sale management will keep track of those limits and visualize them underneath, and it will also prevent you from performing request when near or over these limits

  

  • there are usually multiple tiers of limits, one for specific time-frames (here: 15, 90, and 300 seconds)

  • you're only allowed to perform X requests per time-frame and will be timed out if you exceed that limit

  • each cell has a bar that visualizes the most recent status of those limits, and these bars change color at higher counts (green, orange, red)

• these bars also update in real-time, so you can keep the panel open to see when it's safe to perform server-requests again

• note: these limits are account/IP-specific rather than app-specific, so you might run into them more quickly if you're using multiple apps simultaneously

  • stash-ninja can only keep track based on its own most recent server-request, which means it might not be able to prevent you from running into a time-out if you're using multiple apps simultaneously

• if the most recent server-request returned that you're currently timed out, the rate limits cell will function as a bar that represents the duration of the time-out

  

  • this is also the case if the most recent request was the Nth out of N requests allowed within a time-frame, i.e. it will prevent you from performing the final request that would trip the limiter

Color-Coding in Specific Cases

• the bulk-sale panel uses color-coding to signal certain limitations or special cases

• if an item is already priced, the panel will read the listing on the item, calculate the price, and highlight the market value in teal

  

• when scrolling to adjust bulk-size, the market value column might turn yellow to indicate that the final price will be rounded (if the chosen price multiplied by the bulk-size doesn't equal an even number)

• when configuring a listing that exceeds your stock, exceeds a price of 1200, or is otherwise not valid, the confirm button will turn red and unclickable

  

• when listing an item that doesn't show it's stack-size in the item-tooltip, the confirm button will turn yellow to highlight that bulk-limits are disabled for this item (i.e. it cannot check if you're trying to list more than you actually have)

  

Optional setting: automatic profiles based on minimum trade value

• there is an option to automatically configure profiles 1 to 4 based on the specified minimum trade value (chaos), i.e. the "I don't want to do trades under X chaos" value

  • the main goal is to make it easier to find (stacks of) items that meet that minimum trade value (i.e. that are worthwhile to sell)

  • how it works: activating profile X will highlight item-slots according to a specific price-range, and stacks of X (same number as the profile) or greater will meet the minimum trade value

  • rough rule of thumb: highlighted items meet the trade value if: stack-size >= profile # (more detailed example below)

• profile 5 will be left untouched, in case a vendor/trash tier profile is applicable

• price-range customization will be grayed out if this option is enabled
  

example: 20c minimum trade value

explanation	screenshot
profile 1: - every item-slot worth at least 20c will be highlighted - any stack of at least 1 meets the minimum trade value
profile 2: - every item-slot worth between 10 and 19.99c will be highlighted - any stack of at least 2 meets the minimum trade value
etc.