Graded prices

Use POST /api/v1/graded/prices to request ALT sales for one to four explicit grader/grade/tier markets. Identify a slab first, or use an ALT asset reference you already trust. A raw catalog match is not required for direct ALT pricing.

Every graded lookup through Strata also checks for a verified raw mapping. On a miss, Strata fetches the exact ALT asset identity and automatically queues catalog-only discovery and independent review. Callers do not need to submit a separate linkage proposal. The response adds strataProductId when registration succeeds and rawMatch with the current status: verified, queued, resolving, review_required, unmapped, unsupported, or unavailable. Only verified supplies a usable raw product and its exact selectors. Optional discovery has a 1.5-second deadline and runs alongside graded pricing; its failure leaves the graded quotes usable.

Repeated lookups share the existing discovery job and preserve review history, rejected mappings and attempt limits. A direct ALT ref may also include rawProductId as a candidate hint on first discovery; the worker fetches that product's catalog facts and verifies it through the same review process. A hint never establishes a mapping or enables a raw-origin price comparison. Discovery does not request raw prices or add a customer price operation. Calls made directly to ALT outside Strata cannot be captured automatically.

Generate the operation ID once for a new lookup. On a network retry, rerun only the curl command with the same body and saved ID.

STRATA_OPERATION_ID=$(uuidgen)
curl https://stratatcg.com/connector/api/v1/graded/prices \
  -H "Authorization: Bearer $STRATA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $STRATA_OPERATION_ID" \
  -d '{"ref":{"provider":"alt","entityType":"asset","id":"ALT_ASSET_UUID"},"markets":[{"grader":"PSA","grade":"9"},{"grader":"PSA","grade":"10"}]}'

Use strataProductId in place of ref when pricing a Strata catalog product with a verified ALT link. Keep grader, numeric grade, and tier distinct: for example, 10.5 is used by ALT to represent BGS Black Label or CGC Pristine, not a PSA 10.5. A tier the source cannot map is returned as unsupported rather than merged into another market.

Each distinct grader, numeric grade, and tier is one billable operation. The API normalizes repeated equivalent selections before reserving credits and querying ALT; "10" and "10.0" for PSA are one market. The response contains one quote per distinct normalized market. A market with no usable amount is not charged. A partial quote with an amount can be shown with its status and freshness information; amountCents:null means missing data, never zero.

For a raw-origin cross-market comparison, provide the Strata product ID, its exact TCGplayer rawProductId, and rawSelection with the printing and language. The verified mapping must match those selectors. Raw Near Mint is a reference market; the slab grade does not establish raw condition. Once identity and exact mapping are known, raw and graded price requests can run concurrently.

Inspect each quote's status, amountCents, currency, basis, sampleCount, observedAt, and stale fields. Do not replace no_data, unavailable, or unsupported with zero, or treat an outage as a negative identity result. CardLadder URLs are links only; this endpoint does not scrape CardLadder.

See slab identification, raw and sealed pricing, cross-market recipes, and the OpenAPI response schemas.