SPB Git forge

spb/rareindex

Public
54commits 1branches 0releases
7.1 MBsize
maindefault branch
10 days agolast push
TypeScript 61.9% HTML 37.2% SQL 0.7%
1.2 KB · 10 lines markdown
Rendered Raw Blame History
1# numista — Numista catalogue API (gated)23World coin / banknote / exonumia reference catalogue (N# numbers). Official API v3 with a personal key (`NUMISTA_API_KEY`, header `Numista-API-Key`; free plan 2 000 requests/month). Reported DISABLED until the key exists.45- **Flow**: `GET /types?issuer=&category=&page=&count=50` per configured seed (cursor `{ seedIndex, page }`); optional `fetchPrices` → `/types/{id}/issues` + `/types/{id}/issues/{issue}/prices?currency=EUR` (≤ `maxPricesPerRun` calls).6- **Records**: `catalog_item` per type (`identifiers.numista_id`, catalogue references such as `km_number`, issuer, years, denomination, composition, mandatory attribution "Source: Numista (N#…)") and `price_observation` `guide_value` per grade (F/VF/XF/UNC → taxonomy condition scale) dated with the price call.7- **Licence**: attribution required; no bulk download / feed re-serving; photos referenced only.8- **Fixtures**: built from the official OpenAPI examples (documented in the fixture note) — no live capture possible without a key.9- **Also available (paid tier, not implemented)**: `/types/{id}/sales_records` — auction records with hammer price, premium flag and lot URL.10