FOR DEVELOPERS
Slab Prices API
Current asking prices for graded cards, by grader and grade, for your site, your app or your AI agent.
The Slab Prices API returns current asking prices for graded trading cards, by grader and grade, from the marketplaces Slab Prices follows. Access is by API key. Each key comes with its own limits, agreed with its owner.
For AI agents
Two files describe the API for software, and you can give either one to an agent or a code generator:
- openapi.yaml is the OpenAPI 3 description of every endpoint, parameter and response.
- skill.md is a short skill file for AI agents. It covers how to authenticate, which calls to make and in what order, how to cache, and how the data may be shown. Put your key in the
SLABPRICES_API_KEYenvironment variable, not in the file.
Keys
Send the key with every request as Authorization: Bearer sp_live_... (or in an X-API-Key header). We issue keys by hand: get in touch and tell us what you need. Each key has:
- scopes, which say which endpoints it may call:
graded,cards,history,listings,snapshot; - limits: requests per minute, requests per day, and the largest page;
- optionally, the addresses it may be used from and an end date.
GET /v1/me shows your key's settings and today's usage. Keep the key on a server. The API does not answer browser (CORS) requests, so a key placed in a web page would be exposed and would not work.
Limits
Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (a Unix time), X-Quota-Limit and X-Quota-Remaining. Over a limit you get 429 with Retry-After in seconds. The daily quota resets at 00:00 UTC.
Only accepted requests count. Requests refused for a bad key, a missing scope or a limit do not. A 503 or another server error gives the request back. A 404 and a 304 still count.
Errors
{"error": {"code": "scope_missing", "message": "This API key does not include the \"cards\" scope."}}
| Status | Codes |
|---|---|
| 400 | missing_key, too_many_keys |
| 401 | missing_api_key, invalid_api_key |
| 403 | key_disabled, key_expired, ip_not_allowed, scope_missing |
| 404 | not_found |
| 429 | rate_limited, daily_quota_exceeded, too_many_failed_attempts |
| 503 | busy (retry after Retry-After) |
Prices
All prices are asking prices in US dollars, taken from current listings. They are not sale prices. A card with no graded listing right now has no price.
Graded prices
Two calls cover the usual case, a site that shows prices for its own list of cards. Both need the graded scope. The prices in these examples are real responses from 10 November 2026.
Step 1: find the keys of your cards
GET /v1/graded/index lists the cards, identified by set and number, that have graded listings right now. Search it with q, or narrow it with set and language. Page through it with limit and offset. game defaults to pokemon. Do this once, match the results to your own cards, and store each card's key.
curl -H "Authorization: Bearer $SLABPRICES_API_KEY" \
"https://slabprices.com/v1/graded/index?q=charizard+base+set&sort=listings&limit=2"
{
"data": [
{
"key": "en:cel25cc-CC2~holo",
"name": "Charizard",
"number": "4",
"language": "English",
"game": "pokemon",
"setName": "Celebrations Classic Collection",
"setCode": "CEL:CC",
"printing": "Holo",
"bestAskUsd": 112,
"listingCount": 94,
"url": "https://slabprices.com/card/en:cel25cc-CC2~holo",
"updatedAt": "2026-11-10T22:16:28Z"
},
{
"key": "en:base1-4~holo",
"name": "Charizard",
"number": "4",
"language": "English",
"game": "pokemon",
"setName": "Base Set",
"setCode": "BS",
"printing": "Edition not stated · Holo",
"bestAskUsd": 306.85,
"listingCount": 91,
"url": "https://slabprices.com/card/en:base1-4~holo",
"updatedAt": "2026-11-10T22:16:28Z"
}
],
"meta": {"total": 19, "limit": 2, "offset": 0, "currency": "USD", "priceType": "asking"}
}
bestAskUsd is the lowest asking price across all grades. meta.total is how many cards match, so the next page here is offset=2.
Step 2: get the prices per grade
GET /v1/graded takes the keys you stored, one key parameter per card, up to your page size per request. It returns the lowest asking price for each grader and grade.
curl -H "Authorization: Bearer $SLABPRICES_API_KEY" \
"https://slabprices.com/v1/graded?key=en:cel25cc-CC2~holo&key=en:base1-200"
{
"data": [
{
"key": "en:cel25cc-CC2~holo",
"name": "Charizard",
"number": "4",
"language": "English",
"game": "pokemon",
"setName": "Celebrations Classic Collection",
"setCode": "CEL:CC",
"printing": "Holo",
"url": "https://slabprices.com/card/en:cel25cc-CC2~holo",
"updatedAt": "2026-11-10T22:16:28Z",
"grades": [
{"grader": "CGC", "grade": "10", "lowestAskUsd": 221.5, "listingCount": 31, "marketplaceCount": 4},
{"grader": "PSA", "grade": "10", "lowestAskUsd": 449, "listingCount": 32, "marketplaceCount": 6},
{"grader": "PSA", "grade": "9", "lowestAskUsd": 166, "listingCount": 16, "marketplaceCount": 2}
]
}
],
"missing": ["en:base1-200"],
"meta": {"currency": "USD", "priceType": "asking"}
}
The grades list is shortened here; a real response has every grade that is listed.
missinglists the keys you sent that have no graded listing for sale right now. Usually the last copy sold. It also catches keys we do not know (en:base1-200above does not exist). It is not an error: show "no listings right now" for those cards and ask again on your next refresh.urlis the card's page on slabprices.com. Link the credit to it.listingCountandmarketplaceCountsay how many listings, on how many marketplaces, the price was chosen from.variantStatusappears only when the printing of a card is not fully verified (ambiguous,conflictorunverified). Show that price with care.requestedKeyappears when a key you sent was an older alias of the card's current key. Store the newkey.updatedAtis when our data for the card was last rebuilt.
Caching
Our data refreshes about every 15 minutes, and responses are cached on our side for 10 minutes. Cache on your side too. Responses carry an ETag, and sending it back as If-None-Match returns an empty 304. For a page refreshed daily, one request per batch of cards per day is enough. Spread requests across the day rather than sending them in one burst.
Showing the data
These terms are agreed with each key. Usually they are:
- label every figure as a US asking price;
- credit "Graded listings data from Slab Prices" next to the figures, linking to that card's
url; - use the data for display on your own site only, with no resale, redistribution or bulk copying.
Other endpoints
Keys with other scopes can read full card pages (cards), price history (history), raw listings (listings) and a bulk download of every current listing (snapshot). openapi.yaml describes them all.