B-Stock Deal Finder

Real result from a live run: A Walmart apparel truckload — 11,616 units, Like New condition, Ext. Retail $228,920 — current bid $1,740. That's 0.76% of retail. $0.15 per unit.

Scans B-Stock's live auction marketplace and returns scored liquidation lots ranked by deal quality. Built for resellers, arbitrage buyers, liquidation professionals, and AI agents who need to identify undervalued inventory fast.

What it does

B-Stock is a wholesale liquidation marketplace where major retailers — Amazon, Walmart, Target, The Home Depot, Wayfair and others — auction off overstock, customer returns, and excess inventory in bulk lots. Hundreds of auctions close daily.

This actor queries B-Stock's public API, extracts the key arbitrage signals from each lot (retail value, current bid, unit count, competition level, time remaining), computes a deal score for every result, and returns them ranked best-to-worst.

No browser. No JavaScript rendering. Pure API calls — two requests, under 30 seconds, minimal compute.

Why it's useful

The arbitrage math is embedded in B-Stock's own listing titles:

"Truckload (22 Pallet Spaces) of Apparel, 11,616 Units, Like New Condition, Ext. Retail $228,920"

Current bid: $1,740. That's 0.76% of retail — less than a penny on the dollar. This actor surfaces those opportunities automatically across hundreds of active lots, so you're not manually scanning listings.

Sample output

Deal scoring

Each lot receives a dealScore from 0–100 combining three signals:

Signal	Weight	Logic
Bid/MSRP ratio	50 pts	Lower bid relative to retail = higher score
Unique bidders	30 pts	Fewer competing bidders = higher score
Time urgency	20 pts	Closing sooner = higher score

Results are sorted by dealScore descending. Use minDealScore to run in alert mode — only output lots that exceed your threshold.

Input

Field	Type	Description
maxBidToMsrpRatio	number	Max bid/retail ratio, e.g. 0.2 = bids under 20% of retail
maxUniqueBidders	integer	Max competing bidders — filter out contested lots
closingWithinHours	integer	Only return lots closing within N hours
location	string	Filter by US state code, e.g. KY, FL, TX
categories	array	Product categories to include — see valid values below
retailers	array	Seller storefronts, e.g. Amazon, Walmart
conditions	array	Item condition: Like New, Used Good, Used Fair, Mixed, Salvage
inventoryTypes	array	Overstock, Customer Returns, B-Stock Blue, Mixed/Other
minDealScore	number	Alert mode: only return lots scoring at or above this threshold (0–100)
sortBy	string	API sort field: recommended or endTime
maxResults	integer	Max lots to fetch before filtering (default: 200)
proxyConfiguration	object	Optional proxy settings

Valid categories: Apparel Shoes & Accessories, Automotive Supplies, Books Movies & Music, Building & Industrial, Cell Phones, Electronics, Furniture, Groceries, Health & Beauty, Home & Garden, Jewelry & Watches, Major Appliances, Mixed Lots, Office Supplies & Equipment, Pets, Small Appliances, Sports & Outdoors, Toys Kids & Baby

Output

Each result includes:

Field	Description
dealScore	Computed score 0–100
title	Full lot description
retailer	Seller name
currentBid	Current winning bid in USD
isOpeningBid	true if no bids placed yet — lot is at starting price
msrpEstimate	Retail value from API or parsed from title
bidToMsrpRatio	Current bid divided by MSRP
unitCount	Number of units in the lot
costPerUnit	Current bid divided by unit count
condition	Item condition
inventoryType	Type of inventory (Overstock, Returns, etc.)
uniqueBidders	Number of unique competing bidders
numberOfBids	Total bids placed
nextMinBidAmount	Minimum valid next bid
startPrice	Opening bid price
closingAt	Auction end time (ISO 8601)
minutesRemaining	Minutes until auction closes
region	Lot pickup/shipping location
shipmentType	LTL, Truckload, or Parcel
buyNow	Whether buy-now is available
buyNowPrice	Buy-now price if applicable
auctionUrl	Direct link to the lot on B-Stock
listingPrettyId	Human-readable lot ID

Example use cases

Find closing deals under 10% of retail with low competition

{
    "maxBidToMsrpRatio": 0.1,
    "maxUniqueBidders": 3,
    "closingWithinHours": 6,
    "maxResults": 200
}

Monitor electronics lots from Amazon only

{
    "categories": ["Electronics", "Cell Phones"],
    "retailers": ["Amazon"],
    "maxResults": 100
}

Alert mode — only surface exceptional deals

{
    "minDealScore": 90,
    "maxResults": 500
}

Regional buying — lots you can pick up locally

{
    "location": "KY",
    "maxBidToMsrpRatio": 0.3,
    "maxResults": 200
}

Performance & scheduling

Two lightweight API calls per run — no browser, no DOM rendering. Typical run time is under 30 seconds with minimal compute cost.

B-Stock auctions close continuously throughout the day. Run this actor on a schedule every 1–4 hours to monitor deals in real time and catch lots before the competition finds them. Pair with minDealScore in alert mode to only surface results worth acting on.

Notes

• B-Stock requires a registered buyer account to place bids. This actor surfaces opportunities — you complete the purchase on the B-Stock platform directly.
• Lot availability changes in real time. minutesRemaining and currentBid reflect the moment the actor ran.
• isOpeningBid: true means no one has bid yet — the lot is at its starting price. These are often the highest-ratio results and represent genuine first-mover opportunities.
• MSRP is sourced from B-Stock's API retailPrice field where available, with a fallback to parsing the embedded "Ext. Retail $X" value from the lot title.