xBot Docs

Group settings

Every setting in the item-group panel — what it changes, its default and how it interacts with the rest.

Settings belong to an item group, not to a bot. Open them with the tune icon on the group header. The panel saves automatically: changes are pushed about half a second after the last edit, there is no confirm step.

The panel has four sections, described below in the same order.

Safe setup order

  1. Keep the bot and group disabled.
  2. Choose the algorithms, markup, and analysis period.
  3. Add items and wait for prices to be calculated.
  4. Review prices and quantities in the item table.
  5. Enable buying/selling on intended items, then enable the group and bot.

Changes save automatically. Avoid large batches of edits on a live group until the setup has behaved as expected on a small selection.

Settings

Calculate prices

Type: switch · Default: on

Master switch for this group's pricing. While it is off, items are never queued for price analysis and undercutting stops. Prices already stored on the items are kept and still used for orders and listings.

Pricing also requires Markup above 0 — both conditions must hold.

Analyze before selling

Type: switch · Default: off

Before a listing is placed, the worker pulls the order book and prices the listing one cent below the highest buy order. Ignored when the price was set manually on the item.

Analyze before ordering

Type: switch · Default: on

Holds a buy order back until the item's price analysis is at most 24 hours old. A fresh analysis is reused as is; a stale one is re-queued and the order goes out on a later tick.

Analysis interval

Type: select · Default: Every day · Values: Disabled, 30 min, 1 h, 2 h, 4 h, 6 h, 12 h, 1 day, 2 days, 1 week

How often items with no inventory, orders, listings or pending sale return to a full calculation of both prices. Held stock, including locked copies, uses Active analysis interval and its sell-price policy instead.

Shorter is not faster

A price calculated in the last 20 minutes is reused, so intervals below 20 minutes gain nothing.

Active analysis interval

Type: select · Default: Every day · Values: same as above

How often items with inventory, orders or listings are re-analysed, including locked copies and listings on hold or awaiting confirmation. An unfinished job postpones scheduled analysis. Successful analysis applies the sell-price policy; order policies apply only when orders exist. Insufficient history or an order-book error does not cancel them.

Sell price on active analysis

Type: select · Default: Market price · Values: Market price, Raise only, Keep price

  • Market price — apply the new calculated net sell price even when it falls, provided it meets the retained calculated buy-price floor plus Min. markup.
  • Raise only — apply it only when higher and above the same floor.
  • Keep price — leave the item's sell price unchanged.

The policy also applies to manually requested recalculation when the item has inventory, orders, listings or a pending sale. Successful analysis refreshes its date even when the price stays the same. It does not replace existing sell listings or restore previously reduced prices. The calculated buy price is not the actual acquisition cost of a copy; this policy does not guarantee a profit relative to the amount actually paid.

Orders on active analysis

Type: select · Default: Keep orders · Values: Keep orders, Cancel unprofitable, Reprice orders

  • Keep orders — leave existing buy orders unchanged.
  • Cancel unprofitable — compare the new calculated net sell price after Steam fees with each order's actual buy price plus Min. markup. Cancel only orders below that margin; retain profitable orders.
  • Reprice orders — also cancel orders whose prices differ from the newly recommended buy price. A new order at that price is possible only after a Steam snapshot confirms the old orders are absent, and the filters, minimum margin, available balance, and order limits pass. No replacement is placed when the new price is unprofitable or filters fail.

The policy applies to every order associated with the item, including manually placed orders. Incomplete or failed analysis never cancels orders. When an additional order book is required, cancellation waits for that stage to succeed. Analyze before ordering also applies before a replacement is queued.

Additional

Don't sell tradable items

Type: switch · Default: off

A mode switch, not a filter:

  • On — only non-tradable copies are listed.
  • Off — only tradable copies are listed.

Copies in the other state are never listed at all.

Undercut by a cent

Type: switch · Default: off

Periodically cancels this group's listings and re-lists them one minimal currency unit below the cheapest competitor, never below the Min. markup floor. Requires Calculate prices on and Markup above 0.

Undercut interval

Type: select · Default: Disabled · Values: Disabled, 15 s, 30 s, 1 min, 2 min, 3 min, 4 min, 5 min, 30 min, 1 h, 2 h, 4 h

Minimum time between undercut checks for one item, and the scheduler tick this group is handled by. Undercutting stays off while this is Disabled, even with the switch above turned on.

Delete unconfirmed

Type: switch · Default: on

Cancels sell listings that Steam still reports as awaiting confirmation after 5 minutes. The asset returns to the inventory and the next sell tick lists it again.

Min. markup

Type: number, % · Default: 1

The undercut floor, in percent of the item's buy price. A re-listing happens only while the seller price stays at or above buy price + this percent. Must be above 0 for undercutting to run at all.

Remove listing after

Type: number, days · Default: 0 (off)

Re-lists what is not selling. Once an hour the bot finds listings older than this many days, measured by Steam's own listing date, and runs a full buy and sell recalculation for their items — the same one as the manual "Recalculate": the buy price freeze and the sell price on active analysis policy do not apply to it. After a successful recalculation the old listing is cancelled, the asset returns to the inventory and is listed again at the new price.

  • There is no floor: the actual purchase cost is not stored, so the new price can be below it. Minimum profit limits are measured from the recalculated buy price.
  • The listing stays on the market until the recalculation has finished. If the analysis fails, or the listing is already no dearer than the new sell price, it is not cancelled — it would only lose its place in the queue. The item is tried again a day later.
  • With undercutting of the cheapest listing the price is decided against the order book at placement, so a listing past the limit is always cancelled.
  • Only listings past the limit are cancelled; younger listings of the same item stay.
  • Existing buy orders are left alone: the buy-order policy applies to them at the next active analysis.

Requires Calculate prices, Markup above 0 and selling enabled for the item. 0 disables it.

Profit

Buy algorithm

Type: select · Default: Safe · Values: Maximal, Safe, Average, Low, Buy

Picks how the buy price is derived from the analysis window. The five modes are described in Pricing algorithms.

Buy algorithm, %

Type: number, % · Default: 100

Share of the buy price the buy algorithm produced. 100 keeps it unchanged, 90 bids 10 % lower. A value of 0 is treated as 100.

Outbid the highest buy order by 1 cent

Type: switch · Default: off

After analysis, if the calculated buy price is above the highest competing buy order, it drops to that order plus one cent, never exceeding the calculation. This account's own orders in the same currency are excluded by their unfilled quantity. Enabling this forces an order-book request on every analysis.

Undercut the cheapest listing by 1 cent

Type: switch · Default: off

Before automated placement, a fresh order book is requested even with Analyze before selling off. The target is the cheapest competing buyer-total listing price minus one account-currency minor unit. This account's active listings are excluded by quantity; competing units at the same price level still count.

The two minimum-profit fields below set the floor, not the calculated sell price. Both constraints apply to seller proceeds after Steam fees. For example, a $10.00 purchase with 10% and $2.00 limits requires at least $12.00 seller proceeds. If competition is too cheap or there is none, keep the calculated seller price, raised to the profit minimum if needed. Fees and currency increments are accounted for; if no permissible quote exists, placement is rejected. With both limits zero, selling below the purchase price and calculated sell price is permitted.

This mode does not cancel existing listings or change manual sales. Periodic Undercut by a cent remains independent and uses a different floor — purchase price plus minimum markup. When enabled, this mode replaces the ordinary highest-buy-order adjustment performed by Analyze before selling.

Minimum listing profit, %

Type: number · Default: 0 · Range: 0–10000, at most two decimal places

Minimum per-item profit as a percentage of price_buy, only when listing undercutting is enabled. Profit rounds up to the smallest currency unit; 0 disables this constraint. A positive value applies simultaneously with the fixed-profit limit below.

Minimum listing profit, amount

Type: number · Default: 0 · Range: 0–21474836.47, at most two decimal places

Minimum per-item profit in the Steam account's currency, not a USD value converted by exchange rate. 0 disables this constraint. With two positive limits, seller proceeds after fees must reach the purchase price plus the larger minimum. If the purchase price is unknown for a positive constraint, placement is rejected.

Sell algorithm

Type: select · Default: Safe · Values: Maximal, Safe, Average, Low, Buy

Picks how the sell price is derived from the analysis window, independently of the buy algorithm.

Sell algorithm, %

Type: number, % · Default: 100

Share of the sell price the sell algorithm produced. 100 keeps it unchanged, 105 asks 5 % more. The Steam-side price is re-derived from the result, so the fee relation always holds. A value of 0 is treated as 100.

Markup

Type: number, % · Default: 3

The target margin, measured off the sell price: buy = sell − markup % of sell.

Must be above 0 or the group is never analysed. Values of 100 or more break the calculation. Inside the calculation a markup below 1 is clamped to 1.

Analysis period

Type: number, days · Default: 5

Days of Steam price history fed to the algorithms, ending yesterday — today's trades are used only by the trend filters. Values below 1 are treated as 1. If nothing survives the Corridor filter inside this window, the analysis fails and the item is skipped.

Corridor, %

Type: number, % · Default: 85

Outlier filter: trades deviating from the window average by more than this percent are dropped before the algorithms run. 0 disables filtering. The Average algorithm reads the unfiltered history and therefore ignores this setting.

Analysis filters

These settings never change a price. They decide whether an item may be bought.

Order book coefficient

Type: number, × · Default: 1

Queue limit for buy orders: an order is placed only if the quantity already queued at or above your buy price is not greater than daily sales × this coefficient. 0 skips the check.

Sales per day

Type: number · Default: 1

Minimum average daily sales: the volume traded over the Analysis period divided by its days, rounded down. Items below the bar are not ordered, and the order book is not even requested for them. 0 disables the filter.

Position in listing

Type: number · Default: 5

Maximum allowed position of your sell price in the listing queue. If your Steam sell price would land deeper than this, no buy order is placed. 0 skips the check.

Daily trend, %

Type: two numbers (rise limit, drop limit), % · Default: 100 / 100

Blocks ordering when today's average price drifts from the daily average by more than the given percent. 0 disables that side.

Currently a no-op

Both sides compare today's average with itself, so this filter always passes. Use the weekly and monthly trends to gate on price movement.

Weekly trend, %

Type: two numbers (rise limit, drop limit), % · Default: 100 / 100

Blocks ordering when today's average price rises above the 7-day average by more than the left value, or falls below it by more than the right value. 0 disables that side.

Monthly trend, %

Type: two numbers (rise limit, drop limit), % · Default: 100 / 100

Same as above against the 30-day average.

Defaults at a glance

A new group starts with:

SettingDefaultSettingDefault
Calculate pricesonBuy / Sell algorithmSafe
Analyze before sellingoffBuy / Sell algorithm, %100
Analyze before orderingonOutbid highest buy orderoff
Analysis intervalEvery dayMarkup3 %
Active analysis intervalEvery dayAnalysis period5 days
Sell price on active analysisMarket priceOrders on active analysisKeep orders
Don't sell tradableoffCorridor85 %
Undercut by a centoffOrder book coefficient1×
Undercut intervalDisabledSales per day1
Delete unconfirmedonPosition in listing5
Min. markup1 %Daily / weekly / monthly trend100 / 100
Remove listing after0 (off)Undercut cheapest listingoff
Min. listing profit, %0 (off)Min. listing profit, amount0 (off)

Next

On this page