{"data":{"@kind":"guide","slug":"track-one-card","title":"Inspect one card's public structural state","subtitle":"A keyed lookup with an explicit source-rights boundary.","intro":"The universal-card route exposes a mixed structural document for one requested SKU. Legacy source-derived prices, images, and history are withheld. This guide shows how to preserve that boundary without turning null into zero or keyed lookup into a bulk crawl.","audiences":["agent","hobbyist_coder","aggregator"],"prerequisites":["You know the SKU you want to track"],"estimated_minutes":8,"step_count":3,"steps":[{"step_number":1,"title":"Fetch the current structural state","instruction":"GET the card's universal-mirror representation. The `@content_hash` is the change-detection primitive: same hash = same card facts (no change worth re-rendering); different hash = something changed.","curl":"curl https://cambridgetcg.com/api/v1/universal/card/op-op01-001-ja","expected_response_shape":"{ \"@content_hash\": \"sha256:...\", \"@retrieved_at\": {...}, \"rights\": { \"aggregate\": \"NOASSERTION\", ... }, \"price\": null, \"image_url\": null, ... }","what_to_do_with_it":"Store the content hash only if you need to detect changes in the published structural document. Preserve aggregate NOASSERTION and do not infer a price or image from null."},{"step_number":2,"title":"Cache and request only when needed","instruction":"Honor Cache-Control and fetch a card only for a concrete user request. Do not enumerate SKUs to recreate the paused bulk catalog.","curl":"curl https://cambridgetcg.com/api/v1/universal/card/op-op01-001-ja","what_to_do_with_it":"If the content hash is unchanged, keep your cached structural view. A changed hash means the published document changed; it does not promise that a source price became available."},{"step_number":3,"title":"Read the dated structural view","instruction":"The temporal endpoint `/api/at/[YYYY-MM-DD]/card/[sku]` returns a dated structural document. It performs no price-history read and does not expose a backfill series.","curl":"curl https://cambridgetcg.com/api/at/2026-03-15/card/op-op01-001-ja","what_to_do_with_it":"Use `@as_of` to understand the requested date and `@retrieved_at` for production time. Expect price and image to remain null; do not iterate dates as a substitute for a withheld history export."}],"gotchas":[{"title":"CardRush history is withheld at every delivery tier","description":"Anonymous callers to /api/v1/cards/[sku]/cardrush-history receive 401. Signed-in callers receive HTTP 503 with policy status and an empty observations array. Authentication does not create upstream rights."},{"title":"Null is not zero","description":"A withheld price or image is represented as null. Do not render it as a free card, a zero price, or evidence that the source returned no value."},{"title":"A content hash is not a rights grant","description":"Hashing, normalizing, or transforming an upstream-derived field does not create permission to publish that field."}],"next_guide":{"slug":"respect-our-limits","title":"How to be a polite client","url":"/api/v1/guides/respect-our-limits","html_url":"/agents/guides/respect-our-limits"},"see_also":[{"label":"CardRush policy-status door","href":"/api/v1/cards/op-op01-001-ja/cardrush-history"},{"label":"Cosmology axis: time","href":"/methodology/cosmology"}],"last_verified":"2026-07-12","feedback":{"kind":"guide-feedback","endpoint":"/api/v1/feedback","body_template":{"kind":"guide-feedback","guide_slug":"track-one-card","step_number":"<which step had the issue, or null for whole-guide feedback>","observation":"<what you observed>","expected":"<what you expected>","reporter_contact":"<your email>"}},"html_sibling":"/agents/guides/track-one-card"},"_meta":{"spec_version":"1","endpoint":"/api/v1/guides/[slug]","retrieved_at":"2026-11-19T21:54:24.917Z","as_of":"2026-11-19T21:54:24.917Z","sources":["ctcg-derived"],"freshness_seconds":86400,"license":"CC0-1.0","request_id":"req_815c3232-23a","deprecation":null,"next_link":null,"self_reference":{"this_endpoint":"/api/v1/guides/[slug]","contains_self":true},"source_license":["cc0"]}}