Numista Coin & Banknote Catalog API Wrapper
Under maintenancePricing
Pay per event
Numista Coin & Banknote Catalog API Wrapper
Under maintenanceExtract coin, banknote, and exonumia catalog data from Numista API — 600k+ types, KM numbers, mintage figures, physical specs, and images. Three modes: catalog_walk (by issuer/category/year), type_ids (specific IDs + full detail), search.
Pricing
Pay per event
Rating
0.0
(0)
Developer
BowTiedRaccoon
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
4 days ago
Last modified
Categories
Share
Extract coin, banknote, and exonumia catalog data from the Numista REST API v3 — 600k+ catalogued types, KM (Krause-Mishler) and other cross-reference numbers, physical specs, per-year/mintmark issue and mintage data, and obverse/reverse images.
What you get
- Type records — title, issuer/country, category (coin / banknote / exonumia), sub-classification (e.g. "Standard circulation coins"), min/max year, ruler, physical specs (weight, size, thickness, shape, orientation, composition), face value and currency
- Descriptions — obverse, reverse, and edge design descriptions
- Catalog cross-references — KM number plus the full set of other catalogue numbers (Schön, Wikidata, etc.)
- Issue-level data (optional) — one row per year/mintmark issue with mintage figures, when
includeIssuesis enabled - Images — obverse and reverse full-resolution image URLs
Modes
| Mode | Description |
|---|---|
catalog_walk | Paginated walk of the catalog filtered by issuer / category / year range (default) |
type_ids | Fetch specific Numista type IDs with full detail |
search | Free-text catalog search |
catalog_walk and search results are list items; this actor automatically enriches each one with a full-detail follow-up request before emitting a row, so all three modes produce the same rich schema.
Input
| Field | Type | Description |
|---|---|---|
mode | string | catalog_walk, type_ids, or search. Default: catalog_walk |
issuer | string | Numista issuer slug (e.g. united-states, united-kingdom, france, japon) — not an ISO country code. Look up the exact slug via GET https://api.numista.com/v3/issuers or the catalogue URL on en.numista.com. Used in catalog_walk mode |
category | string | coin, banknote, or exonumia. Leave blank for all categories |
minYear / maxYear | integer | Year range filter for catalog_walk |
typeIds | array | Numista numeric type IDs to fetch (e.g. ["1492"] — the Morgan Dollar). Used in type_ids mode |
query | string | Free-text search query. Used in search mode |
includeIssues | boolean | Fetch per-year/mintmark issue + mintage data for each type. Doubles API calls but adds mintage detail. Default: true |
language | string | Catalog description language. Default: en |
maxItems | integer | Maximum number of catalog types to walk. When includeIssues is enabled, each type can fan out into many issue rows, so total output rows may exceed maxItems |
Rate limits
Numista issues a per-key request quota (2,000+/day on the free tier) and a per-second rate limit. This actor respects Retry-After on HTTP 429 automatically and runs at a conservative default pace.
Use cases
- Numismatic price guides — join on KM number / catalogue cross-references against price-guide data (e.g. NGC population reports) for a full catalog + pricing stack
- Collection cataloguing — pull full physical specs and images for a personal or dealer collection
- Mintage research — per-year/mintmark mintage figures for rarity analysis
- World coin reference — the largest open catalog of foreign/world coins, complementing US-centric price guides
