# numista — Numista catalogue API (gated)

World 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.

• 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).
• 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.
• Licence: attribution required; no bulk download / feed re-serving; photos referenced only.
• Fixtures: built from the official OpenAPI examples (documented in the fixture note) — no live capture possible without a key.
• Also available (paid tier, not implemented): /types/{id}/sales_records — auction records with hammer price, premium flag and lot URL.