INTRODUCTION
PokeDeck AI is the world's first intelligent platform that combines computer vision, real-time market analytics, and Solana blockchain technology to revolutionize how collectors manage, trade, and compete with their Pokémon TCG collections.
Our platform uses GPT-4V vision models to instantly identify any Pokémon card from a photo — determining the exact set, card number, rarity, edition, and condition. This data feeds into our predictive analytics engine, which tracks pricing across eBay, TCGPlayer, and global auction houses to give you real-time portfolio intelligence that no other platform offers.
PokeDeck AI is currently in closed beta. All features, endpoints, and documentation are subject to change. API rate limits and availability may vary during the beta period.
QUICK START
Get up and running with PokeDeck AI in under 5 minutes. Follow these steps to connect your account, configure your AI scanner, and start building your intelligent collection.
SYSTEM ARCHITECTURE
PokeDeck AI is built as a distributed microservice architecture designed for low latency, high availability, and seamless scaling. Here's how the major components interact:
AI CARD SCANNER
The AI Card Scanner is the heart of PokeDeck AI. Using a multi-model vision pipeline (GPT-4V primary, Gemini Vision fallback), it identifies Pokémon TCG cards from photographs with 94% accuracy in under 2 seconds. The scanner extracts:
- Card Identity — Name, set, card number, rarity, edition (1st edition, unlimited, reverse holo, etc.)
- Condition Grading — AI grades on a scale matching PSA/BGS standards: Mint, Near Mint, Excellent, Good, Poor
- Centering Analysis — Measures border ratios (60/40, 65/35, etc.) to predict professional grading outcomes
- Surface Defects — Detects scratches, whitening, print lines, and other defects via pixel-level analysis
- Authenticity Check — Cross-references holo patterns, font metrics, and color profiles against known fakes
- Market Pricing — Automatically pulls live pricing from TCGPlayer, eBay sold listings, and global auction data
How the Vision Pipeline Works
When you submit an image, it goes through a 4-stage pipeline:
AI grading is an estimate and should not replace professional grading services (PSA, BGS, CGC). Our 94% accuracy is measured against a test set of 2,000 pre-graded cards. Results may vary with poor image quality.
AUTO-DECK BUILDER
The Auto-Deck Builder is an AI system that constructs tournament-viable Pokémon TCG decks from your personal collection. Input your playstyle preference — aggro, control, tempo, or combo — and the engine analyzes your available cards against the current competitive meta to build the strongest possible deck.
How It Works
- Collection Analysis — The AI maps your entire scanned collection, identifying key cards, synergies, and type coverage
- Meta Intelligence — Our engine tracks top tournament results worldwide, updating the meta snapshot daily from official and community tournament data
- Deck Generation — Using constraint satisfaction and optimization algorithms, the AI generates 3-5 deck candidates that maximize win probability within your collection
- Battle Simulation — Each candidate deck is stress-tested against the top 10 meta decks across 1,000+ simulated games. Win rates, matchup spreads, and consistency scores are calculated
- Budget Optimization — Optionally set a budget cap. The AI will suggest affordable upgrades that maximize competitive improvement per dollar spent
MARKET INTELLIGENCE
PokeDeck AI aggregates pricing data from every major marketplace in real time, then layers AI predictions on top to give you an unfair advantage in the Pokémon TCG market. Our models are trained on 5+ years of historical sold listings, tournament results, set releases, and community sentiment data.
Data Sources
- TCGPlayer — Live market prices, lowest listings, and volume data for all English TCG cards
- eBay Sold Listings — Actual completed sale prices, not just asking prices. Updated every 15 minutes
- CardMarket — European pricing data for international portfolio tracking
- Crypto Auctions — NFT and blockchain-based card auction prices from OpenSea, Magic Eden, and custom Solana markets
- Tournament Data — Official Pokémon TCG tournament results that drive meta shifts and card demand
AI Predictions
Our prediction engine uses a custom transformer model fine-tuned on TCG market dynamics. It factors in upcoming set releases, ban list announcements, tournament results, social media buzz, and seasonal patterns. Predictions include:
- 7-day forecast — Short-term price movement direction and magnitude
- 30-day trend — Medium-term trajectory with confidence interval
- Spike alerts — Real-time notifications when a card is about to surge based on leading indicators
- Portfolio score — Your collection's overall health and projected growth rate
All price predictions are experimental and should not be treated as financial advice. Past performance does not guarantee future results. The TCG market is volatile — always do your own research.
BATTLE SIMULATOR
The Battle Simulator runs full Pokémon TCG game simulations using official rules. It powers the deck builder's testing pipeline and will soon be available as a standalone feature for practice and training.
- Full Rules Engine — Implements complete Pokémon TCG ruleset including Abilities, Trainer effects, Stadium rules, prize cards, weakness/resistance
- AI Opponents — Multiple difficulty levels from Beginner to Champion-level play with adaptive strategy
- Meta Deck Library — Pre-built versions of all current tier 1-3 competitive decks to test against
- Statistical Output — Win rate, average prize cards taken, turn count, opening hand quality, consistency metrics
The standalone Battle Simulator is currently in development. Deck builder simulations are available in beta. Interactive play mode expected in Q3 2025.
NFT MINTING
Turn your verified physical Pokémon cards into digital assets on Solana. Each NFT is cryptographically linked to a real card verified by our AI scanner, creating a trustless bridge between physical and digital collectibles.
Minting Process
NFT minting is currently available on Solana devnet only. No real SOL is required. Mainnet launch is pending security audit completion. Testnet NFTs will not transfer to mainnet.
AI TRADING BOT
The AI Trading Bot is a 24/7 autonomous agent that monitors marketplaces for deals matching your criteria. It can alert you to price drops, propose swap deals with other collectors, and execute pre-approved trades automatically.
Capabilities
- Price Watch — Set target prices for any card. Get instant alerts when listings match your criteria across eBay, TCGPlayer, and CardMarket
- Deal Scoring — Every listing gets an AI-calculated "deal score" (0-100) based on price vs. market value, seller reputation, and card condition
- Swap Engine — The bot identifies collectors who have cards you want and want cards you have. Proposes fair swap deals with transparent value calculations
- Auto-Execute — For pre-approved trades, the bot can execute purchases automatically within your budget limits. All transactions are logged and reversible within 24h
- Portfolio Rebalancing — AI suggests sells and buys to optimize your collection's value, liquidity, and competitive viability
The Trading Bot is in early alpha testing with a limited number of testers. Auto-execution is disabled by default. Join the waitlist for early access.
TELEGRAM AUCTIONS
Host live card auctions directly inside Telegram groups. The PokeDeck bot manages the entire process — listing, bidding, time management, bid verification, and escrow via Solana smart contracts. Zero fees during beta.
Auction Flow
- Create Listing — Seller sends a scan of their card to the bot. AI verifies condition and sets a suggested starting price
- Live Bidding — The bot posts the auction in your Telegram group with a countdown timer. Bidders react or reply to place bids
- Anti-Shill Protection — AI monitors bidding patterns to flag suspicious activity and protect buyers from price manipulation
- Escrow Settlement — Winner's SOL is held in a Solana smart contract. Released to seller only after buyer confirms receipt of the physical card
- Reputation System — Both parties rate each other after the trade. Reputation scores are stored on-chain and visible across all PokeDeck auctions
API OVERVIEW
The PokeDeck AI API is a RESTful JSON API with WebSocket support for real-time streams.
All endpoints require authentication via API key in the Authorization header.
Base URL
Authentication
Include your API key in every request:
Rate Limits
| Plan | Requests / min | Scans / day | WebSocket Streams |
|---|---|---|---|
| Free (Beta) | 30 | 50 | 1 |
| Pro | 120 | 500 | 5 |
| Enterprise | Unlimited | Unlimited | Unlimited |
Error Codes
| Code | Meaning | Description |
|---|---|---|
400 | Bad Request | Invalid parameters or missing required fields |
401 | Unauthorized | Missing or invalid API key |
403 | Forbidden | API key lacks permission for this endpoint |
404 | Not Found | Resource does not exist |
429 | Rate Limited | Too many requests — slow down |
500 | Server Error | Something went wrong on our end |
SCAN ENDPOINTS
| Parameter | Type | Description | |
|---|---|---|---|
| image | string | Required | Base64-encoded image or public URL. Max 20MB. Supports JPEG, PNG, WebP, HEIC. |
| model | string | Optional | Vision model to use. gpt-4v (default), gemini, or auto (tries both). |
| include_pricing | boolean | Optional | Include live market pricing. Default: true |
| include_grading | boolean | Optional | Include AI condition grading. Default: true |
| include_authenticity | boolean | Optional | Run authenticity verification. Default: false |
| price_sources | string[] | Optional | Markets to pull prices from. Options: tcgplayer, ebay, cardmarket |
| currency | string | Optional | Price currency. Default: USD. Supports: USD, EUR, GBP, JPY |
| Parameter | Type | Description | |
|---|---|---|---|
| scan_id | string | Required | The scan ID returned from POST /v1/scan |
| Parameter | Type | Description | |
|---|---|---|---|
| limit | integer | Optional | Results per page. Default: 20, Max: 100 |
| offset | integer | Optional | Pagination offset. Default: 0 |
| set_code | string | Optional | Filter by card set code |
MARKET ENDPOINTS
| Parameter | Type | Description | |
|---|---|---|---|
| card_id | string | Required | Card identifier (e.g., sv4-006) |
| Parameter | Type | Description | |
|---|---|---|---|
| card_id | string | Required | Card to watch |
| target_price | number | Required | Price threshold in USD |
| direction | string | Required | above or below |
| notify_via | string[] | Optional | webhook, telegram, email |
DECK ENDPOINTS
| Parameter | Type | Description | |
|---|---|---|---|
| playstyle | string | Required | aggro, control, tempo, or combo |
| format | string | Optional | standard (default), expanded, unlimited |
| budget_limit | number | Optional | Max USD spend for missing cards |
| simulation_rounds | integer | Optional | Battle simulations per candidate. Default: 500 |
NFT ENDPOINTS
| Parameter | Type | Description | |
|---|---|---|---|
| scan_id | string | Required | ID of a verified scan with authenticity check passed |
| wallet_address | string | Required | Your Solana wallet address (Phantom, Solflare, etc.) |
| network | string | Optional | devnet (default) or mainnet (coming soon) |
| royalty_bps | integer | Optional | Creator royalty in basis points. Default: 500 (5%) |
| collection | string | Optional | Collection name to group NFTs together |
JAVASCRIPT SDK
Our official JavaScript/TypeScript SDK provides type-safe access to all PokeDeck AI endpoints with built-in retry logic, rate limit handling, streaming support, and comprehensive error types.
PYTHON SDK
WEBHOOKS
Receive real-time notifications when events occur — price alerts triggered, auctions ended, scans completed, or trades proposed. Webhooks are sent as HTTP POST requests to your configured endpoint.
Available Events
| Event | Description |
|---|---|
scan.completed | A card scan has been processed and results are ready |
price.alert | A price alert threshold has been hit |
price.spike | AI detected an unusual price movement for a card in your portfolio |
auction.bid | Someone placed a bid on your auction |
auction.ended | An auction has concluded |
trade.proposed | The AI trading bot found a match and proposes a swap |
nft.minted | Your NFT mint transaction has been confirmed on-chain |
SECURITY
Security is a core pillar of PokeDeck AI. We handle sensitive data including wallet connections, card collections worth thousands of dollars, and financial transactions on the Solana blockchain. Here's how we protect you:
API Security
- TLS 1.3 — All API traffic is encrypted in transit. We reject connections using older TLS versions
- API Key Rotation — Generate, revoke, and rotate keys from your dashboard. Old keys are invalidated immediately
- IP Allowlisting — Restrict API access to specific IP addresses or CIDR ranges (Pro plan and above)
- Rate Limiting — Per-key rate limits prevent abuse. Automatic throttling protects against DDoS
- Webhook Signatures — All webhook payloads include HMAC-SHA256 signatures for verification
Wallet Security
- Non-Custodial — We never store your private keys. All wallet interactions use signed transaction requests
- Transaction Approval — Every blockchain transaction requires explicit approval from your wallet (Phantom, Solflare)
- Escrow Contracts — Auction escrow uses audited Solana smart contracts with time-locked release mechanisms
Data Protection
- Encryption at Rest — All stored data is encrypted using AES-256. Database backups are encrypted independently
- Data Retention — Scan images are deleted after 90 days. You can request immediate deletion at any time via API
- GDPR Compliant — Full data export and deletion available. We don't sell your data to third parties
Scam Detection
- Fake Card Detection — AI-powered authenticity verification catches known counterfeit patterns
- Shill Bid Protection — Machine learning models detect suspicious bidding patterns in Telegram auctions
- Seller Verification — On-chain reputation scores help identify trusted traders
We run a responsible disclosure program. If you discover a security vulnerability, please report it to security@pokedeck.ai. Eligible reports receive bounties from $100 to $10,000.
ROADMAP
PokeDeck AI is actively evolving. Here's what we're building and when you can expect it:
FAQ
What cards does PokeDeck AI support?
Currently, we support all English-language Pokémon TCG cards from Base Set (1999) through the latest Scarlet & Violet expansions — over 18,400 unique cards. Japanese and other language support is planned for Q4 2025.
How accurate is the AI grading?
Our AI grading achieves 94% accuracy against a test set of 2,000 pre-graded cards (PSA, BGS, CGC). It's designed as a quick estimate — not a replacement for professional grading. Accuracy improves with better image quality, lighting, and angle. We recommend a flat, well-lit surface with no glare.
Is the API free during beta?
Yes. All beta users get free access to the API with limits of 30 requests/minute and 50 scans/day. Pro and Enterprise tiers will be available at launch with higher limits and additional features. Beta users will receive a discount on paid plans.
How does NFT minting work with physical cards?
You scan your physical card, which creates a verified digital record. This record — including card data, AI grade, and authenticity hash — is minted as an NFT on Solana. The NFT represents a verified digital twin of your physical card. It does NOT replace ownership of the physical card — both exist independently.
Is my collection data private?
Absolutely. Your collection data is encrypted and private by default. We never share or sell your data. You can export or delete all your data at any time via the API or dashboard. We are GDPR compliant.
What wallets are supported?
We support Phantom and Solflare for Solana wallet connections. More wallet integrations (Backpack, Glow) are coming in Q3 2025. All wallet interactions are non-custodial — we never have access to your private keys.
Can I use PokeDeck AI for other card games?
Not yet. We're 100% focused on Pokémon TCG right now to deliver the best possible experience. Support for Magic: The Gathering and Yu-Gi-Oh! is on our 2026 roadmap.
How do I report a bug or security issue?
For bugs, join our Discord or Telegram community and report in the #bugs channel. For security vulnerabilities, email security@pokedeck.ai. We have an active bug bounty program with rewards from $100 to $10,000 for eligible reports.