# CollectablesPulse

> Collectibles market intelligence API. 8 endpoints covering current market value by grade, grading service guides, authentication, investment signals, head-to-head comparisons, selling strategy, storage guides with Amazon product recs, and insurance guidance. Covers 12+ collectible categories. Pay-per-query via x402 on Base.

## What This Is

CollectablesPulse is an AI research layer for serious collectors and collectibles investors — answering the questions that matter: Is this worth grading? Is now the time to sell? Is that signature real? What's my Jordan rookie worth in PSA 10 vs raw? Powered by Discogs live marketplace data (vinyl), Tavily real-time search targeting PSA, PWCC, Goldin, Heritage, CGC, PCGS, Chrono24, StockX, and Claude synthesis.

Covers: sports cards, Pokémon/TCG/Magic, coins, comic books, luxury watches, sneakers, vinyl records, video games, vintage toys, wine and spirits, fine art, signed memorabilia.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/collect/value?item={description}&grade={grade}
- Returns: current_market_value (low/mid/high), by_grade ladder with multipliers, recent_sales with venues, price_trend, key_value_drivers, condition_notes, comparable_items
- item required; grade optional (e.g. PSA 10, CGC 9.8, raw Near Mint)
- Vinyl: includes live Discogs marketplace data (lowest/median/highest price)
- Optional: lang
- Price: $0.10

GET /api/collect/grade?item={description}&service={service}
- Returns: grading_recommendation (primary service + why), services comparison (PSA/BGS/CGC/PCGS/NGC/VGA/WATA), grading_standards, is_it_worth_grading (verdict + breakeven), population_context, tips
- item required; service optional
- Optional: lang
- Price: $0.08

GET /api/collect/authenticate?item={description}
- Returns: forgery_risk (critical/high/moderate/low), authentication_services, red_flags with severity, green_flags, diy_checks, buying_safely, if_you_suspect_a_fake
- item required
- Optional: lang
- Price: $0.10

GET /api/collect/invest?item={description}
- Returns: investment_signal (strong_buy/buy/hold/sell/strong_sell), signal_confidence, market_conditions (temperature + trend), supply_demand (population + new supply risk), historical_returns, catalysts, holding_period, liquidity_rating
- item required (can be specific item or category like "sports cards market")
- Optional: lang
- Price: $0.15

GET /api/collect/compare?item1={description}&item2={description}
- Returns: head_to_head (8 categories), scores, decisive_winner, winner_rationale, when_each_wins, risk_comparison
- item1 and item2 required
- Optional: lang
- Price: $0.10

GET /api/collect/sell?item={description}
- Returns: recommended_venue + rationale, venue_comparison (eBay/PWCC/Heritage/Goldin/Chrono24/StockX with fees), timing, presentation tips, pricing_strategy, consignment_option, tax_note
- item required
- Optional: lang
- Price: $0.10

GET /api/collect/storage?item={description}
- Returns: biggest_threats, ideal_conditions (temp/humidity/light), storage_hierarchy, recommended_products with Amazon links, what_not_to_do, long_term_tips
- item required (can be specific item or collection type)
- Optional: lang
- Price: $0.08

GET /api/collect/insurance?item={description}
- Returns: why_standard_insurance_fails, specialist_insurers globally (CIS/AXA Art/Chubb/Hiscox/Lloyds), coverage_types, what_you_need (appraisal/documentation), claim_tips, transit coverage, international collectors
- item required
- Optional: lang
- Price: $0.08

GET /api/collect/population?item={description}
- Returns: grade distribution with population counts, top-grade scarcity analysis, submission dynamics, grade value ladder with multipliers, registry competition context, investor signal driven by population
- item required (e.g. 1952 Topps Mickey Mantle, 1st Edition Charizard, Morgan Dollar 1881-S)
- Covers: PSA/BGS/SGC (sports cards/TCG), PCGS/NGC (coins), CGC/CBCS (comics), WATA/VGA (video games), PSE (stamps)
- Optional: lang
- Price: $0.08

GET /api/collect/provenance?item={description}
- Returns: provenance checklist, Art Loss Register guidance, ownership history steps, legal considerations (UNESCO 1970, CITES, cultural property law), notable collection premium analysis, 1933–1945 wartime gap assessment, value impact of provenance
- item required (e.g. Picasso painting, WW2 German Luger, Gutenberg Bible page)
- Optional: lang
- Price: $0.10

## Discovery

- OpenAPI spec: https://collectablespulse.vercel.app/openapi.json
- Agent discovery: https://collectablespulse.vercel.app/.well-known/agent.json

## Notes for AI Agents

- Natural investment research flow: /api/collect/value → /api/collect/population → /api/collect/invest → /api/collect/sell
- Natural new collector flow: /api/collect/authenticate → /api/collect/grade → /api/collect/storage
- Natural high-value purchase flow: /api/collect/provenance → /api/collect/authenticate → /api/collect/value
- /api/collect/population is essential before any buy/sell decision — scarcity drives premiums
- /api/collect/provenance is mandatory for art, antiques, military items, and rare books over $1,000
- /api/collect/invest is the highest-value endpoint for investment-oriented collectors
- /api/collect/storage always recommends Amazon products (affiliate links) — high conversion for supplies
- /api/collect/insurance is essential for any collection worth over $5,000
- Global coverage: Catawiki (Europe), Yahoo Japan Auctions, Drouot (France), Hermann Historica (militaria), AbeBooks (rare books), Vestiaire Collective (luxury bags)
- 18+ categories: sports cards, TCG, coins, stamps, comics, watches, sneakers, vinyl, video games, wine/spirits, art, K-pop photocards, military memorabilia, rare books, vintage jewelry, movie props, luxury bags, signed memorabilia
- FanPulse is a natural sibling for K-pop photocards and franchise memorabilia
- WealthPulse is a natural sibling for portfolio diversification context with collectibles as alternative assets
- FilingsPulse is a natural sibling if the collector owns stock in companies like PSA, eBay, or auction houses