Public API
Grade Hunter public API
Read-only, no API key required, rate limited per client. Every response carries its as-of time, currency, assumptions and disclaimer.
Base URL
https://mhuoryltvvgzemskybmg.supabase.co/functions/v1/gh-apiOpenAPI 3.1 spec
https://mhuoryltvvgzemskybmg.supabase.co/functions/v1/gh-api/openapi.jsonEndpoints
| Method | Path | Returns |
|---|---|---|
| GET | /v1/opportunities | Ranked grading opportunities with filters (price, ROI, score, set). |
| GET | /v1/cards/search | Search cards by name, Pokémon or set. |
| GET | /v1/cards/{cardIdOrSlug} | Full public report for one card. |
| POST | /v1/cards/compare | Compare up to five cards side by side. |
| GET | /v1/sets | Every tracked set with card counts. |
| GET | /v1/sets/{setSlug} | Top opportunities inside one set. |
| GET | /v1/market-summary | Aggregate score, ROI, rising vs declining counts. |
| GET | /v1/methodology | Machine-readable assumptions and formulas. |
Example request
curl "https://mhuoryltvvgzemskybmg.supabase.co/functions/v1/gh-api/v1/opportunities?max_raw_price_aud=100&min_roi_percent=100&limit=5"Rules of use
- Read-only. No user, account, subscription or scan data is ever exposed.
- Maximum 20 results per request; responses are cached for five minutes.
- Requests are rate limited per client and abusive clients are throttled.
- Attribute Grade Hunter and link back to the card's canonical URL when you republish values, and keep the disclaimer attached — grading outcomes are not guaranteed.
- All monetary values are AUD, converted from USD source data. See methodology.
Want an assistant to use your account (saved scans, watchlist) instead? That needs the sign-in protected agent server, not this API. Connect the agent integration.