Help Center

Getting an API key is easy:

1. Go to the Customer Portal
2. Sign up or log in with your email (magic link) or OAuth (Google/GitHub)
3. Navigate to the "API Keys" section in your dashboard
4. Click "Create New API Key" and give it a descriptive name
5. Copy your key immediately - it won't be shown again for security

Free tier users get instant access to 100 API calls/month. For higher limits, check our Pricing page.

PriceDepth aggregates completed-sale data from multiple verified sources, organized into a three-tier hierarchy:

• Tier 1 — Auction houses: in-person grading verification, the institutional reference standard.
• Tier 2 — Marketplaces: high-volume completed-sale data with broad coverage.
• Tier 3 — On-chain: verifiable settled trades across multiple blockchains.

The full per-source roster and weighting matrix are shared under NDA with institutional customers. Public-facing details are in our Methodology documentation.

PriceDepth calculates fair market value (FMV) using the median sale price of all verified sales within a rolling 30-day window. We use the median (not mean) because it's more robust to outliers like shill bids or distressed sales.

Each price response includes:

• price_usd - The median FMV
• price_range.low - 25th percentile (P25)
• price_range.high - 75th percentile (P75)
• confidence - Data quality score (1-5)
• liquidity - Market activity tier

For thin markets with no recent sales, we fall back to 90-day and all-time windows. See our Methodology for full details.

Rate limits and monthly quotas are tied to your plan:

• Free: 100 calls/month for sandbox testing.
• Pro ($29.99/mo): 1,000 calls/month, portfolio tracking, price alerts, and full price history.
• Platform ($199/mo): 10,000 calls/month, embeddable widgets, white-label pricing, bulk lookup, and priority support.
• Enterprise (custom): Unlimited volume, custom SLA, and dedicated support for institutional use.

Rate-limit headers are included in every response:

• X-RateLimit-Limit — Per-minute request budget
• X-RateLimit-Remaining — Requests remaining in the current window
• X-RateLimit-Reset — Unix timestamp when the window resets
• X-Monthly-Quota / X-Monthly-Used — Monthly call budget and usage

If you exceed a limit you’ll receive 429 Too Many Requests with a Retry-After header.

Data freshness varies by source class:

• Marketplaces: Refreshed multiple times per day on a tiered schedule based on liquidity.
• Auction houses: Ingested within 24 hours of auction close.
• On-chain: Near real-time as trades settle on-chain.

Daily FMV snapshots are calculated at midnight UTC and stored for historical queries. The last_updated field in API responses indicates when the price was last recalculated.

Create a price alert by POST’ing to /v1/alerts with a card_id, alert_type (above, below, or percent_change), and threshold_value. You can deliver to email, a webhook URL, or both:

POST /v1/alerts
X-Api-Key: YOUR_API_KEY

{
  "card_id": "1999 Pokemon Base Charizard #4|10",
  "alert_type": "above",
  "threshold_value": 50000,
  "webhook_url": "https://your-server.com/hook"
}

List your alerts with GET /v1/alerts and remove them with DELETE /v1/alerts/:id. Full payload schema is in the API reference.

Yes. Historical price data is available via the /v1/cards/:id/history endpoint. You can:

• Query daily FMV snapshots by date range
• Get point-in-time prices for any date: GET /v1/cards/:id/price?date=2026-01-15
• Access raw comp data via the /v1/cards/:id/comps endpoint

Historical data depth varies by card — most cards have data going back to January 2025, with ongoing backfill for earlier periods.

We use API key authentication. Pass your key in the X-Api-Key request header:

X-Api-Key: YOUR_API_KEY

The Customer Portal (/portal/*) uses JWT bearer tokens (Authorization: Bearer <token>) issued during sign-in — this is separate from the public API.

Keep your API keys secure: store them in environment variables, never embed them in client-side code, and rotate them from the portal if you suspect exposure.

All API responses are in JSON format. Key fields in a price response include:

• price_usd - Fair market value in USD
• price_range - Object with low and high bounds
• confidence - Data quality score (0-5)
• liquidity - Market liquidity tier
• sources - Array of contributing data sources
• last_updated - ISO 8601 timestamp
• methodology_version - Version used for calculation

Error responses include error and message fields with HTTP-appropriate status codes.

Our public pricing is intentionally simple:

• Pro ($29.99/mo): For collectors and portfolio enthusiasts. 1,000 API calls/month, portfolio tracking, price alerts, full price history, and email support.
• Platform ($199/mo): For card shops, dealers, and platforms. 10,000 API calls/month, embeddable widgets, white-label pricing, bulk lookup, and priority support.
• Enterprise (custom): For institutions, dapps, marketplaces, and funds. Unlimited volume, webhooks, custom SLA, dedicated support, and direct access to the engineering team.

Trial keys are available for evaluation. See our Pricing page for a side-by-side comparison or email [email protected] to scope an institutional plan.

Upgrading is simple:

1. Log in to the Customer Portal
2. Go to "Billing & Plans" in the sidebar
3. Select your desired plan and click "Upgrade"
4. Enter payment details (we use Stripe for secure processing)
5. Your new limits take effect immediately

When upgrading mid-cycle, you'll be charged a prorated amount for the remainder of the billing period. Downgrades take effect at the start of the next billing cycle.

Yes, we offer a 14-day money-back guarantee on all paid plans. If you're not satisfied within the first 14 days, contact [email protected] for a full refund.

After 14 days, we don't offer refunds, but you can downgrade or cancel your plan at any time. Your access will continue until the end of your current billing period.

We look at real completed sales from major auction houses, marketplaces, and on-chain venues, then calculate the median price from the last 30 days of sales. The median filters out unusual sales like shill bids or fire sales, giving you a more accurate picture of what a card is actually selling for. Each price also includes a confidence score so you know how reliable the estimate is.

Most card prices update every few hours as new sales come in. Major auction house results are added within 24 hours of the auction closing. You can always check the "last updated" date on any card page to see how fresh the data is.

We support PSA, BGS (Beckett), CGC, and SGC graded cards, plus ungraded/raw cards. Each grade level (PSA 10, PSA 9, BGS 9.5, etc.) has its own price tracking, so you can see exactly what your specific card and grade combination is worth.

Yes! Create a free account, add your cards to your collection, and we'll track the total portfolio value daily. You can see value changes over 7, 30, or 90 day periods, plus your overall profit and loss based on what you paid for each card.

Browsing card prices, searching the database, and basic portfolio tracking are completely free. Our paid plans (Pro $29.99/mo, Platform $199/mo, and custom Enterprise) are designed for collectors, developers, and platforms. The consumer interface is free forever.

Navigate to any card's detail page and click the "Set Alert" button. You can set alerts for when a card goes above or below a specific price. We'll notify you when the threshold is crossed so you never miss a buying or selling opportunity.