GET/alt/assetapiKey1 credit/request
Returns one card design's identity, full population report (across every grading company and grade Alt tracks), and a recent raw sales feed -- the "is this card actually rare, and what does it sell for" data for a specific card design, independent of any single listing. asset_id comes from a prior alt-search/alt-sold-listings/alt-card-search result's asset_id field. recent_sales has no per-transaction grade breakdown -- Alt does not expose one; see alt-sold-listings for per-grade sold prices on specific listings.
Required: asset_id.
Sampled 14 Oct 2026: 1183 items. Not in every item: date (500), price (500). In the sample: date: 2026-07-07 to 2026-10-12; price: 2,760 to 516,000, median 9,200.
Open in Playground
GET/alt/auctionsapiKey2 credits/request
Searches Alt's own currently live auctions -- the same pool shown on alt.xyz/browse's "Auctions" tab filtered to the Alt source. Unlike alt-search, this never returns another source auction house's listings or Alt's own fixed-price items. See alt-categories for the accepted category/grading_company/sort values.
Optional: q, category (16 allowed values: BASEBALL_CARDS, POKEMON_CARDS, FOOTBALL_CARDS, BASKETBALL_CARDS, POP-CULTURE_CARDS, HOCKEY_CARDS, SOCCER_CARDS, ONE_PIECE_CARDS, OTHER_CARDS, TCG_CARDS, COMBAT_SPORTS_CARDS, RACING_CARDS, MAGIC_CARDS, YUGIOH_CARDS, GOLF_CARDS, TENNIS_CARDS), grading_company (21 allowed values: PSA, CGC, BGS, CSG, SGC, PSA/DNA, BVG, BCCG, Factory Sealed, BAS, AUTHENTIC, TAG, RELABEL, RECASE, JSA/BVG, REVIEW, INTERNAL, NEW/, BULK, OTHERS, UNGRADED), sort (8 allowed values: recommended, alt_value_desc, alt_value_asc, price_desc, price_asc, watched_desc, ending_soonest_asc, timestamp_desc), page, per_page.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, asset_id, listing_id, name, subject, year, brand, variety and 12 more. Not in every item: bid_count (18), watch_count (19), card_number (18), autograph (3), serial (5), print_run (5), view_count (15), badges (7). In the sample: expires_at: 2026-10-16 to 2026-10-23; category: POKEMON_CARDS (15), BASKETBALL_CARDS (4), BASEBALL_CARDS (1); year: 1,998 to 2,025, median 2,004; name: “1998 Pokemon Promo Japanese Corocoro Comics Holo Pikachu Il…” and 18 other values; images: median 2 entries; subject: “Pikachu Illustrator” and 15 other values; brand: “Pokemon Promo Japanese” and 16 other values; variety: “Corocoro Comics Holo” and 12 other values.
Open in Playground
GET/alt/card-searchapiKey2 credits/request
Searches Alt's reference card-design catalog -- a canonical catalog of card designs (one entry per year/brand/subject/card-number/variety combination), separate from live listings or sales. Useful for finding a card design's asset_id (to feed into alt-asset for a population report and recent sales) without already having a live listing or sale that references it.
Optional: q, page, per_page.
Sampled 14 Oct 2026: 20 items. Filled in every item: asset_id, name, subject, year, brand, card_number, category, pop. Not in every item: external_transaction_count (6), variety (15). In the sample: category: BASKETBALL_CARDS (13), NON-SPORT_CARDS (6), BASEBALL_CARDS (1); year: 1,993 to 2,009, median 1,997; name: “1993 High School Heroes II Michael Jordan #12” and 19 other values; brand: “High School Heroes II” and 11 other values; card_number: “12” and 19 other values; pop: 1 to 694, median 98; external_transaction_count: 2 to 12, median 11; variety: “In Air” and 9 other values.
Open in Playground
GET/alt/categoriesapiKey2 credits/request
Returns every accepted value for alt-search/alt-auctions/alt-sold-listings' category, auction_house, grading_company, and listing_type params, plus the sort enum. category/auction_house/grading_company/listing_type are read live from Alt's own current search index on every call, not a fixed taxonomy -- so this endpoint self-corrects if Alt's aggregator adds a new source auction house, grading company, or category.
Takes no parameters.
Sampled 14 Oct 2026: 5 fields returned with a value. In the sample: category: 16 entries; auction_house: 7 entries; grading_company: 22 entries; listing_type: 4 entries; sort: 8 entries.
Open in Playground
GET/alt/listingapiKey1 credit/request
One listing's full public detail -- title, description, price/bid state, grading info, and images -- across Alt's own native listings and its aggregated external listings. id and listing_type come from a prior alt-search/alt-auctions result, or from an alt-sold-listings result's listing_id and listing_type for a completed sale on Alt itself. Not every response field applies to every listing_type -- see the field-level notes in this endpoint's markdown doc.
Required: id, listing_type (4 allowed values: AUCTION, FIXED_PRICE, EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE).
Sampled 14 Oct 2026: 22 fields returned with a value. In the sample: expires_at: 2026-09-25; year: 2,007; listing_type: “AUCTION”; description: 1,052 characters; badges: 2 entries; auction_house: “Alt”; name: “2007 Exquisite Collection Dual Logoman Autographs Kobe Brya…”; subject: “Kobe Bryant/Lebron James”.
Open in Playground
GET/alt/market-trendsapiKey1 credit/request
Returns Alt's own category-level price-trend index -- the same data alt.xyz's "Market Trends" page shows: a weekly/monthly/90-day change and a current index value per card category, built from Alt's own sold/valuation data.
Optional: category.
Sampled 14 Oct 2026: 7 items. Filled in every item: category, start_date, end_date, current_index_value, weekly_change, weekly_index_change, monthly_change, ninety_day_change and 1 more. In the sample: start_date: 2026-07-11; weekly_change: 0 to 0.07, median 0.01; category: “BASKETBALL_CARDS” and 6 other values; end_date: 2026-10-11; monthly_change: 0.01 to 0.17, median 0.02; ninety_day_change: 0.05 to 0.29, median 0.06.
Open in Playground
GET/alt/searchapiKey2 credits/request
Searches Alt's universal aggregator index -- live auction and fixed-price listings from Alt itself and every other source auction house its search carries (eBay, Fanatics Collect, Pristine Auction, Goldin, CardHobby, Memory Lane) -- by free-text query, category, source auction house, grading company, and listing type, in a caller-selected sort order. Only currently-live listings are returned; see alt-sold-listings for completed sales. See alt-categories for the accepted category/auction_house/grading_company/listing_type/sort values.
Optional: q, category (16 allowed values: BASEBALL_CARDS, POKEMON_CARDS, FOOTBALL_CARDS, BASKETBALL_CARDS, POP-CULTURE_CARDS, HOCKEY_CARDS, SOCCER_CARDS, ONE_PIECE_CARDS, OTHER_CARDS, TCG_CARDS, COMBAT_SPORTS_CARDS, RACING_CARDS, MAGIC_CARDS, YUGIOH_CARDS, GOLF_CARDS, TENNIS_CARDS), auction_house (7 allowed values: eBay, Fanatics Collect, Alt, Pristine Auction, Goldin, CardHobby, Memory Lane), grading_company (21 allowed values: PSA, CGC, BGS, CSG, SGC, PSA/DNA, BVG, BCCG, Factory Sealed, BAS, AUTHENTIC, TAG, RELABEL, RECASE, JSA/BVG, REVIEW, INTERNAL, NEW/, BULK, OTHERS, UNGRADED), listing_type (4 allowed values: AUCTION, FIXED_PRICE, EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE), sort (8 allowed values: recommended, alt_value_desc, alt_value_asc, price_desc, price_asc, watched_desc, ending_soonest_asc, timestamp_desc), page, per_page.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, asset_id, listing_id, name, subject, year, brand, variety and 12 more. Not in every item: autograph (1), serial (2), print_run (2), bid_count (13), watch_count (15), view_count (13), badges (8), pop (18). In the sample: expires_at: 2026-10-16 to 2026-10-23; brand: Upper Deck (8), Upper Deck MJ Living Legend (3), Upper Deck Michael Jordan Maste… (2) and 5 more; year: 1,995 to 2,012, median 2,008; name: “2012 Upper Deck Jordan Unc Master Collection Letterman "I"…” and 16 other values; badges: median 2 entries; variety: “Letterman "I"” and 8 other values; card_number: “L-MJ” and 16 other values; auction_name: Oct 02 - Oct 15, 2026 (12), Oct 09 - Oct 22, 2026 (8).
Open in Playground
GET/alt/sold-listingsapiKey2 credits/request
Searches Alt's global archive of completed card sales, aggregated across every source auction house its search carries -- the "market data" side of Alt's card-investment-marketplace positioning. This is a separate index from alt-search/alt-auctions, scoped to a rolling recent time window, not a filtered view of live listings. Pass auction_house=Alt to see only Alt's own completed sales. Each of Alt's own sales carries listing_id and listing_type -- pass both to alt-listing to get that item's certificate number -- and its url is the alt.xyz item page; a sale aggregated from another auction house carries that source site's own url instead. See alt-categories for the accepted category/auction_house/grading_company values.
Optional: q, category (16 allowed values: BASEBALL_CARDS, POKEMON_CARDS, FOOTBALL_CARDS, BASKETBALL_CARDS, POP-CULTURE_CARDS, HOCKEY_CARDS, SOCCER_CARDS, ONE_PIECE_CARDS, OTHER_CARDS, TCG_CARDS, COMBAT_SPORTS_CARDS, RACING_CARDS, MAGIC_CARDS, YUGIOH_CARDS, GOLF_CARDS, TENNIS_CARDS), auction_house (7 allowed values: eBay, Fanatics Collect, Alt, Pristine Auction, Goldin, CardHobby, Memory Lane), grading_company (21 allowed values: PSA, CGC, BGS, CSG, SGC, PSA/DNA, BVG, BCCG, Factory Sealed, BAS, AUTHENTIC, TAG, RELABEL, RECASE, JSA/BVG, REVIEW, INTERNAL, NEW/, BULK, OTHERS, UNGRADED), page, per_page.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, asset_id, listing_type, name, subject, year, brand, variety and 10 more. Not in every item: pop (19). In the sample: sold_date: 2026-08-06 to 2026-10-11; listing_type: EXTERNAL_FIXED_PRICE (11), EXTERNAL_AUCTION (9); year: 1,995 to 1,999, median 1,998; url: ebay.com and 1 other host; images: median 1 entry; name: 1998 SP Top Prospects Phi Beta… (5), 1995 Jordan Time Capsule Jordan… (5), 1999 Upper Deck Black Diamond J… (4) and 3 more; brand: SP Top Prospects Phi Beta Jordan (7), Jordan Time Capsule (5), Upper Deck Black Diamond Jordan… (4) and 2 more; variety: Phi Beta Jordan (7), Jordan Time Capsule (5), Jordan Diamond Gallery (4) and 2 more.
Open in Playground
GET/alt/top-moversapiKey1 credit/request
Returns Alt's biggest price-index movers -- either a cross-subject leaderboard (optionally scoped to one category) or, when subject is set, that one player/character's own trend broken out per category it appears in. category is not strictly validated against alt-categories' list -- this trend index's own category set is broader (e.g. it includes MULTI-SPORT_CARDS).
Optional: category, subject, limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: subject, category, start_date, end_date, current_index_value, weekly_change, monthly_change, ninety_day_change. In the sample: start_date: 2025-10-11; weekly_change: 0.02 to 0.07, median 0.03; subject: “Tim Duncan” and 19 other values; end_date: 2026-10-11; monthly_change: -0.01 to 0.15, median 0.05; ninety_day_change: 0 to 0.71, median 0.14.
Open in Playground