The free account-gated pricing path is described in member pricing: it uses separate native-currency observations and source-specific display/feed permissions. Its current coverage comes from stored successful runs, not the existence of an adapter. The warehouse architecture below is the older CardRush-shaped archive; its legacy values remain withheld. TCGplayer and CardRush prices are display-only on Cambridge pages and never served by the API or in downloads; signing in does not change that.
Where this lives in code. The aggregation pipeline ispackages/data-ingest/src/<source>/(one module per upstream). The wholesale writer atapps/wholesale/src/lib/ingest/<source>.tspersists rows toprice_archivewith(card_id, snapshot_date, source, condition)uniqueness. The cross-source view endpoint is/api/v1/prices/[sku]/sourceson wholesale (bearer-gated). The auditpnpm --filter @cambridge-tcg/admin cross-source-divergenceflags outliers across sources for the same card+date.
Every upstream module exports a typed SourceMeta object declaring four things that propagate to every byte that leaves the platform:
| Property | What it means | Where it surfaces |
|---|---|---|
access | How we may reach the source (public-api / public-file / oauth2 / scrape / paid-feed / partner / blocked). | /api/v1/sources response. |
license | The redistribution tier. cc0, cc-by, cc-by-nc, mit, partner-redistributable, internal-only, proprietary. | _meta.source_license array on every response that touches that source's data. |
freshness | The platform's intent on staleness (catalog 24h, price_current 5min, price_historical immutable, market_signal 1min). | _meta.freshness_seconds on every response. |
redistribute | Whether we may re-export raw upstream values verbatim. true requires evidence that an open license covers the upstream data itself, not merely the API client code. | price_archive.source_redistribute per row; propagated through _meta downstream. |
| Source | Region | Currency | License tier | Cadence | Conditions captured |
|---|---|---|---|---|---|
| CardRush | Japan | JPY | internal-only | Legacy archive frozen; its legacy acquisition stays disabled (latest snapshot: see /prices/coverage). Member display only, collected only while scheduled (see /api/v1/sources) | NM (status A-) in the legacy archive; a stated grade where the page states one |
| TCGplayer | US | USD | proprietary | Member display only, collected only while scheduled (see /api/v1/sources); none in price_archive | The condition each price-guide row states; none in price_archive |
| Cardmarket | Europe | EUR | proprietary | Public daily files; Cambridge collects Cardmarket's One Piece files daily (see the Cardmarket entry at /api/v1/sources) | Not in price_archive; member observations keep source metrics (average, low, trend), not conditions |
The price archive can carry a source's native amount plus a GBP-normalised value computed at write time. Rows in price_archive are legacy CardRush JPY observations (legacy acquisition disabled). TCGplayer rows have not landed there. CardRush, TCGplayer and Cardmarket observations for the member feed live separately, in their native currency, and are not GBP-normalised. When conversion occurs, the rate is captured per-row in fx_rate_to_gbp with a fx_rate_source declaration (live / cached / fallback), so an archived conversion retains the rate provenance recorded at capture time.
Substrate honesty applied to FX: the row is the platform's view of what the source charged in GBP at the moment of capture. It is not marked up; we don't transform a TCGplayer market signal into a Cambridge retail price. Cross-source comparison happens at the substrate level.
Some pricing sources publish several fields. A permitted, implemented reader must declare which field becomes the prominent value and retain the rest with provenance. Only CardRush has an active choice today.
| Source | Headline field | Rationale |
|---|---|---|
| CardRush | A-condition retail JPY | One value per card; no spread offered upstream. |
| TCGplayer | Not selected | Not in this legacy guide. TCGplayer prices are display-only on Cambridge pages and never served by the API or in downloads. |
| Cardmarket | Not selected | Not selected for this legacy guide. The member feed keeps Cardmarket metrics (average, low, trend and others) distinct rather than choosing one headline; see /methodology/member-pricing. |
When two permitted sources eventually price the same card on the same date and disagree meaningfully (max/min ratio > 1.5×), the platform is designed to preserve the disagreement rather than hide it in an average. With one observed source today, this is an architecture rule, not a claim of current cross-source coverage. Two kinds of divergence will matter:
pnpm --filter @cambridge-tcg/admin cross-source-divergence flags outliers (> 5×) for operator review.The platform's job is to surface the disagreement honestly, not decide which source “wins”. Substrate honesty applied to cross-source aggregation: when sources disagree, the response carries every source's row, not an opaque consensus.
Public price responses declare their sources and known source-rights tier in the response envelope's _meta.sources and _meta.source_license arrays. That declaration is a boundary signal, not a substitute for the upstream terms or field-level lineage:
The TCGplayer reverse-lookup door at /api/v1/federation/identify/by-upstream is dormant and returns a blocked status. Stored upstream identifiers are not made CC0 merely because Cambridge holds a mapping. Reopening requires written approval covering publication of those identifiers.
The substrate widened from one source (CardRush) to many across two kingdoms in May 2026: kingdom-066 (the-cardrush-alignment) added the source column to price_archive; kingdom-080 (the-tcgplayer-alignment) widened the unique key to include condition and added the extra JSONB column plus generalised FX provenance. Adding another source reuses that storage shape, but it is not merely mechanical: access, use, and redistribution rights must be established before its reader is activated.