Skip to main content
AuctionDex homeAuctionDex

How it works

Where the listings come from, how they are grouped, and how to read a card.

Where listings come from

AuctionDex reads auction listings from marketplace APIs, normalizes them into one consistent shape, and groups them by how much time is left. The launch marketplace is eBay. Nothing is scraped from marketplace web pages.

During development the site runs on local demonstration fixtures instead of live API data. Where that is the case, a “Demo data” marker appears in the site header.

How auctions are grouped

Time-remaining groups use fixed boundaries, inclusive of the lower bound:

  • Under 2 minutes — more than 0 and less than 2 minutes left
  • 2–5 minutes
  • 5–15 minutes
  • 15–60 minutes
  • Ending today — an hour or more away, closing on the same UTC day
  • Ended — the end time has passed

Additional groups cover no-bid listings, low-priced listings, and listing type: graded, raw, sealed and card lots.

How to read a card

  • Countdown — time until the marketplace closes the auction. It updates in your browser and shows “Ended” once the time passes. It never counts into negative time.
  • Current bid — the bid at the time the listing was retrieved, not a final price and not a valuation.
  • Shipping — shown when the marketplace states it. When it does not, the card reads “Shipping not stated” and no total is calculated, because an invented total would understate what you pay.
  • Bids — “No bids” means zero bids. “Bids unknown” means the marketplace did not supply a count; the two are never merged.
  • Grading badges — read from the listing title. They are the seller’s claim. Verify a certification number with the grading company before bidding on anything expensive.

Your eBay account

AuctionDex reads public listing information through eBay’s official APIs. You do not need an eBay account to use this site, and there is currently no way to connect one — every link simply takes you to the listing, where eBay handles sign-in, bidding and payment.

As a condition of using eBay’s APIs, AuctionDex operates an endpoint that receives marketplace account deletion notifications. Since the site keeps no eBay marketplace-user account data, those notifications are acknowledged and there is nothing stored to erase. If account-linked features are added later, deletion requests will remove the applicable stored account-linked data.

Outbound links

Clicking a card opens the original marketplace listing in a new tab. Those links may carry affiliate tracking — see the affiliate disclosure. Affiliate tracking never changes which listings are shown or the order they appear in.