Greysheet, guide values & fair value

CDX surfaces Greysheet-linked pricing context for lots listed from SpotPro Software with a GSID and stored guide/GS prices — without a Greysheet API lookup on every browse or lot page view.

Seller console · Lots Seller guide Buyer guide

Feature status: Live in beta — fair-value badges, public guide/GS chips, lot snapshots, seller free sync / stale API refresh, and a nightly snapshot cron.

Why this is a feature

For buyers

See whether a bid or Buy Now is near / rich / steep vs greysheet or guide (and melt when that is the better anchor). Cards and lots can show GS $… · Guide $….

For dealers

Keep Greysheet current in SpotPro with your keys. CDX reuses those stored numbers for marketplace context without burning lookups on traffic.

Cost model (important)

When the Greysheet API runs

Action	Greysheet API?
Buyer browses or opens a lot	Never — stored / snapshot only
List or relist from inventory	Never — free snapshot of SpotPro prices
Seller console → Sync GS (free)	Never — re-copy from inventory
Seller console → Refresh GS (API if stale)	Only if snapshot older than ~24h and keys work
Nightly cron	Always free SpotPro re-copy; API only for stale lots with the seller’s own keys (not trial)
SpotPro Greysheet inventory update	Yes — dealer’s normal SpotPro Software run (source of truth)

What buyers see

Fair-value badge

great / fair / rich / steep — e.g. “Near guide · $121 · MS70” when guide/GS data is present.

Chips & melt

Guide chips — stored Greysheet / guide dollars
Melt / % vs melt on bullion (independent of Greysheet)
Comps language only when there are enough similar sold lots

Auction prices vs Greysheet

What we never overwrite

Your listing prices stay yours. GS sync / nightly cron / API refresh update only reference fields (guide/GS snapshot for badges and chips). They do not change starting bid, reserve, fixed Buy Now, or live-spot Buy Now settings.

You set on the lot	What GS update does
Buy Now $100 on a GS-linked item whose guide is $75	BIN stays $100. Fair-value may say Rich / Steep vs guide · $75 — context, not a price change.
Starting bid / reserve	Unchanged by GS snapshot or cron
Live metal Buy Now	Still tracks metal + your premium/floor — not Greysheet
Inventory fixed price in SpotPro Software	CDX GS sync does not rewrite sell price

Fair-value uses the higher of current bid or Buy Now (when BIN is set) as the ask compared to guide/melt.

What sellers should do

Workflow

Link inventory items to a GSID in SpotPro (same as SpotPro Greysheet workflow).
Run Greysheet price updates in SpotPro Software when you want fresh dealer numbers.
List to CDX Auction — a snapshot is taken automatically (free).
Optional during a long auction: Seller console → Lots → Sync GS (free) after a SpotPro update, or Refresh GS (API if stale).

Nightly stale-snapshot cron

What runs overnight

Every live SpotPro-linked lot: re-copy stored inventory Greysheet/guide values (free)
Stale or missing snapshot + GSID: optionally call Greysheet once with that seller’s own keys
Trial / platform keys are not used
API volume capped per run and per seller

Technical notes

Inventory: gsid, last_gs_price, last_guide_price
Lot snapshot: snap_gs_cents, snap_guide_cents, snap_gs_at, snap_gs_source
Fair-value prefers lot snapshot → live SpotPro stored → melt/comps (never live API on read)
Cron: members/cron-cdx-auction-gs-snapshot.php