Kingpin Market

Preview one of the connected seller's own listing drafts: title, price, category, condition, specs, image count, and exactly what's still required or recommended before it can be published on Kingpin. Read-only.

Deep-dive one of the connected seller's own listings: a quality score with specific fixes plus a price benchmark against current comparable listings (same category and condition). Read-only; pricing is a benchmark, not a guarantee.

List the connected account's own saved Concierge searches with criteria, budget, alert cadence, and status. Archived searches are hidden unless includeArchived is true. Read-only.

Score the connected seller's own active and draft listings for quality (title, description, brand, photos, condition notes, price) and surface the lowest-scoring listings with specific fixes. Read-only.

List the offers the connected account has made as a buyer, with status (pending/accepted/rejected/expired), amount, and listing. Read-only.

List the connected account's own saved (wishlist) listings with title, price, and a Kingpin link. Read-only.

Report whether the connected Kingpin account can create drafts now and what's still needed to publish (seller approval, payout setup, shipping options, active listings). Read-only; use it to guide the seller, not to block drafting.

List the connected seller's own active listings that haven't sold or been refreshed in a while, with suggestions to revive them. Read-only.

Create a shareable link token for the connected account's OWN wishlist, so a gift-finder can preview it. Link-shared only: the token exposes just your active public saved listings (never private data), and no one can browse your wishlist without it. Read-only for your account. Share the token with someone so they can call getWishlistSharePreview.

Preview the gear on a Kingpin wishlist that its owner explicitly shared, using the opaque share token from their share link. Returns only public, currently-active listing cards (title, price, image, Kingpin link) plus the owner's display name — never private wishlist data, contact details, or the owner's identity beyond their public display name. Read-only; ideal for finding a gift from someone's shared wishlist. Returns found=false for an invalid, unshared, or revoked token.

Make an offer on a Kingpin listing for the connected account. Requires confirmation: call once to preview the offer and any blockers, then again with confirm=true to submit. The offer must be below the asking price and at least 10% under it; you can't offer on your own or a non-active listing. Rate-limited per Kingpin's normal offer limits.

Publish one of the connected seller's own DRAFT listings to the live Kingpin marketplace. Requires explicit confirmation: call once to preview what will go live and the blockers, then again with confirm=true to publish. Enforces required fields, at least one photo, an active shipping or local pickup zone, no off-platform payment language, seller-currency alignment, and explicit confirmation of ambiguous default category/condition values. Grail-draw listings must be published on Kingpin.

Remove a listing from the connected account's own wishlist. Idempotent.

Save a Kingpin listing to the connected account's own wishlist. Idempotent — saving an already-saved listing is a no-op.

Search active Kingpin fingerboard listings by free text, category, brand, condition, deck width, budget, and currency. Returns public listing cards with price, condition, brand, key specs, and a Kingpin link. Read-only and safe for public discovery.

Update fields on one of the connected seller's existing DRAFT listings (title, description, category, condition, price, currency, brand, visibility, specs). Only works on drafts the seller owns; refuses published or others' listings. Returns the updated draft summary and remaining gaps.