# Guardian TCG - Complete Platform Documentation

> The market intelligence and infrastructure layer for the collectibles market

## Overview

Guardian TCG is a real-time trading card game (TCG) market analytics platform that monitors card marketplaces, detects price movements and anomalies, and performs social sentiment analysis across 14 TCGs. It provides real-time alerts, portfolio tracking, AI-powered card grading, and a subscription-based system delivering comprehensive market insights.

## Platform Capabilities

### Price Tracking & Market Data
- Real-time price tracking across 14 trading card games
- 69,050+ cards indexed with price history
- Multi-source pricing from TCGPlayer, PriceCharting, JustTCG, and eBay
- Weighted price averaging with confidence scoring
- Price history charts with 7D, 30D, 90D, 1Y, and All-time views
- Market movers: top gainers and losers updated in real-time
- Graded card price tracking (PSA, BGS, CGC grades)

### Market Intelligence
- Buyout detection algorithms with configurable thresholds
- Market event classification (surge, buyout, post-buyout, suspicious)
- Multi-timeframe analysis for trend detection
- Social sentiment analysis from Reddit and Twitter
- Sleeper card detection for undervalued cards
- Market heatmap visualization across all supported TCGs

### AI Features
- Card Scanner: On-device ML using YOLOv8n object detection and MobileCLIP-S2 for embedding-based matching, achieving sub-500ms recognition
- AI Card Grading: GPT-4o Vision analyzes 8 photos for centering, corners, edges, and surface condition, providing BGS-style subgrades
- AI Portfolio Assistant: GPT-4o-mini powered chat for portfolio analysis and recommendations
- OCR: Tiered backends with Apple Vision/ML Kit preferred over Tesseract.js
- Rarity symbol classification for card identification

### Portfolio Management
- Double-entry accounting system with cost basis tracking
- Profit & Loss calculation per card and overall
- Portfolio performance charts and analytics
- Portfolio benchmarking with percentile ranking
- Collection portfolios for organizing cards by strategy
- Shareable portfolio links
- CSV import from TCGPlayer, eBay, Collectr, and other platforms

### Collection Features
- Card collection management with quantity, condition, and purchase price tracking
- Set completion tracking with progress indicators
- Wishlist management
- Collection sharing with friends
- Collection analytics with rarity distribution and game breakdown

### Social Features
- User profiles with collector tiers (Starter to Mythic)
- Friend system with collection viewing
- Leaderboard rankings
- Trade proposals between users
- Guardian Lists: curated and user-created card collections with performance tracking

### Alert System
- Custom price alerts with configurable thresholds
- Buyout and surge notifications
- Discord integration for real-time alerts
- Web push and native iOS push notifications
- Alert deduplication to prevent spam
- Smart alert suggestions based on portfolio

## Supported Trading Card Games

1. Pokemon (English)
2. Pokemon (Japanese)
3. Pokemon (Chinese)
4. Pokemon (Korean)
5. One Piece (English)
6. One Piece (Japanese)
7. Magic: The Gathering
8. Yu-Gi-Oh!
9. Digimon
10. Lorcana
11. Union Arena
12. VeeFriends
13. LEGO
14. Riftbound

## Pricing Plans

### Free Tier
- Real-time price tracking for all 14 TCGs
- 40 lifetime card scans
- Basic collection management
- Top 3 market movers
- Wishlist and watchlists
- Friend collections and sharing

### Guardian Pro - $7.99/month or $59.99/year
- Unlimited card scans
- Full price history charts
- Graded card prices
- Custom alerts
- Market screener
- CSV import
- Discord integration
- Full market movers list
- AI card grading (15/month)
- Portfolio analytics

## API Access

Guardian TCG offers a free Pricing Oracle REST API for developers and AI agents:
- Card search and lookup
- Real-time pricing data
- Price history
- Set and game data
- Daily market brief with social-ready copy: GET /api/v1/market/brief
- Browser extension overlay (no key): GET /api/extension/overlay?q={title}
- **Guardian Oracle MCP** (live): GET/POST /api/mcp/oracle — search_cards, get_card_price, get_graded_prices, get_market_movers
- **Agent discovery catalog** (no checkout): GET /api/v1/discovery/products
- Documentation: https://guardiantcg.app/developers/api
- Agent quickstart: https://guardiantcg.app/AGENT_QUICKSTART.md
- MCP connector (ChatGPT/Claude): https://guardiantcg.app/MCP_CONNECTOR.md
- Partner settlement guide: https://guardiantcg.app/ORACLE_PARTNER_QUICKSTART.md
- OpenAPI 3.0: https://guardiantcg.app/api/v1/openapi.json
- LLM site index: https://guardiantcg.app/.well-known/llms.txt

## Distribution & Data Moats

- **Market Brief Hub** (https://guardiantcg.app/market/brief): Daily AI brief + programmatic social copy (X threads, Discord embeds, newsletter blocks)
- **Browser Extension**: Guardian prices on TCGPlayer, eBay, Cardmarket (download from /extension)
- **Evaluated price oracle**: settlement.allowed, canonical symbology, refusal to price low-confidence SKUs
- **Content bundle API**: GET /api/market/content-bundle for ops/automation pipelines

## Technical Architecture

- Frontend: React 18, TypeScript, Tailwind CSS, Recharts
- Backend: Node.js, Express, PostgreSQL with Drizzle ORM
- ML: ONNX Runtime for on-device inference, WebGPU acceleration
- Mobile: Progressive Web App + Capacitor for native iOS/Android
- Data: Multi-source pricing pipeline with spike validation and quarantine system

## Company Information

- Website: https://guardiantcg.app
- Twitter: @GuardianTCG
- Discord: Available through the platform
- Blog: https://guardiantcg.app/blog