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_KEY environment variable, not in the file.

openapi.yaml skill.md

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."}}
StatusCodes
400missing_key, too_many_keys
401missing_api_key, invalid_api_key
403key_disabled, key_expired, ip_not_allowed, scope_missing
404not_found
429rate_limited, daily_quota_exceeded, too_many_failed_attempts
503busy (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.

  • missing lists 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-200 above does not exist). It is not an error: show "no listings right now" for those cards and ask again on your next refresh.
  • url is the card's page on slabprices.com. Link the credit to it.
  • listingCount and marketplaceCount say how many listings, on how many marketplaces, the price was chosen from.
  • variantStatus appears only when the printing of a card is not fully verified (ambiguous, conflict or unverified). Show that price with care.
  • requestedKey appears when a key you sent was an older alias of the card's current key. Store the new key.
  • updatedAt is 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.