Quickstart

Everything the catalogue knows is available as JSON. The public endpoints need no key, no account and no Authorization header; the catalogue is meant to be read.

Resource	Where
Base URL	`https://api.restrike.co/v1`
OpenAPI 3.0 document	api.restrike.co/openapi.json
Interactive reference	docs.restrike.co/api/reference
Agent index	restrike.co/llms.txt

First requests

Find a type by name or catalogue number:

curl -s 'https://api.restrike.co/v1/types?q=krugerrand&pageSize=5'

Read one type in full, issues included:

curl -s 'https://api.restrike.co/v1/types/south-africa/krugerrand/1-ounce'

Price its fine gold at spot, and convert:

curl -s 'https://api.restrike.co/v1/spot'
curl -s 'https://api.restrike.co/v1/rates'

Walk a country's coinage:

curl -s 'https://api.restrike.co/v1/issuers/south-africa'
curl -s 'https://api.restrike.co/v1/issuers/south-africa/series'
curl -s 'https://api.restrike.co/v1/types?issuer=south-africa&sort=weight_desc&pageSize=50'

When to reach for this API

It answers structured questions about a specific gold coin, which is a narrower job than it sounds and the one thing it does better than a search engine:

Resolve a coin to its specification. GET /types?q=<name or KM#> does the lookup and gives you back fields, not prose: fine gold in grams, fineness, gross weight, diameter, thickness, years.
Compare two coins on the same axes. Every type is described to one specification. Two GET /types/{issuer}/{series}/{type} responses are directly comparable field by field with no translation step.
Melt value. GET /spot publishes the gold price this site prices with, per gram and per troy ounce; multiply a type's fineWeight by pricePerGram. GET /rates converts USD into another display currency off the same ECB table the pages use, so your numbers and ours agree.
Read a year table. A type response carries every issue: year, mint letter, finish, mintage, variety and marks.
Enumerate a catalogue. Issuer, then series, then types, paginated, and GET /mints/{mint} for everything one mint strikes.

Do not reach for it to value a specific coin (numismatic premiums are not modelled), to grade or authenticate one, to look up anything about a specific physical coin (provenance, slab numbers), or to transact: nothing here buys or sells.

Endpoints

Method	Path	What it returns
`GET`	`/issuers`	A page of issuing authorities (roots by default), with counts and a lead picture
`GET`	`/issuers/highlighted`	The hand-picked row the home page leads with
`GET`	`/issuers/{slug}`	One issuer, its sub-issuers and the shape of its catalogue
`GET`	`/issuers/{issuerSlug}/series`	The series filed under an issuer's tree
`GET`	`/issuers/{issuerSlug}/series/{seriesSlug}`	One series, with statistics
`GET`	`/types`	A page of types; filter by issuer, series, mint or free text
`GET`	`/types/{issuerSlug}/{seriesSlug}/{slug}`	One type: full specification, sides, pictures and issues
`GET`	`/mints`	A page of mints
`GET`	`/mints/{slug}`	One mint and the series it strikes
`GET`	`/spot`	The gold spot price, USD per gram and per troy ounce
`GET`	`/rates`	USD to display-currency conversion table
`GET`	`/sitemap/types`	Every type's URL identity and last-modified date, 5,000 a page
`GET`	`/sitemap/catalog`	Every root issuer, series and mint, as URL identities

The full request and response shapes for each are in the interactive reference, generated from the same OpenAPI document the API serves.