# Restrike Docs

How the Restrike gold coin catalogue is built: the philosophy, where the data comes from, and the public API that serves all of it.

- [Overview](/index): What Restrike is, and what this documentation covers.
- [Philosophy](/philosophy): The premise Restrike is built on, and the principles that follow from it.
- [Where the data comes from](/data/): How the catalogue is authored, sourced and kept clean.
- [The catalogue](/data/catalogue): The structure of the reference layer in Numista's vocabulary, issuer to series to type to issue, with mints across it.
- [Quickstart](/api/quickstart): The Restrike API in five curl commands. No key, no account, no Authorization header.
- [Versioning and deprecation](/api/versioning): What can change inside a version, and how a version winds down when it must.
- [Rate limits](/api/rate-limits): The public budget, the headers that report it, and what a 429 looks like.
- [Errors](/api/errors): One JSON shape for every failure, with a stable machine-readable code.
- [Agent access](/api/agents): The machine-readable routes into Restrike, for tool generators and agents.
- [Terms of use](/api/terms): Free to read and free to build on, with two conditions.
- [Restrike API](/api/reference): A read-only reference for gold coins: the catalogue (issuers, series, types, issues, mints), in Numista's vocabulary, with the gold price the melt values rest on. ## When to use this API Reach for it when you need **structured facts about a specific coin** rather than prose about gold in general: - Resolve a coin to its type (`GET /types?q=Krugerrand`) and read back its fine weight, fineness, diameter, years and issues as fields rather than sentences. - Compare two coins on the same axes. Every type in the catalogue is described to one specification, which is the point of it; two `GET /types/{issuerSlug}/{seriesSlug}/{slug}` calls are directly comparable field by field. - Put a melt value on a coin: `GET /spot` gives USD per gram of fine gold, and `GET /rates` converts it into another display currency off the same ECB table. - Find what a mint has struck (`GET /mints/{slug}`) and every type carrying its letter. - Enumerate an issuer's catalogue: `GET /issuers/{slug}`, then `GET /issuers/{issuerSlug}/series`, then `GET /types?issuer=...`. It is **not** the right tool for valuations beyond melt, for authentication advice, for anything about a specific physical coin (a grade, a slab, a provenance), or for placing an order: nothing here transacts. ## Access The catalogue, spot and rates endpoints are public: no key, no account, no `Authorization` header. The `/wallet` group belongs to a signed-in player: it needs a session cookie of any role, and answers 401 without one. ## Versioning and deprecation The current version is **v1**, served at `https://api.restrike.co/v1`. Build against the prefixed URL. The same paths answer without the prefix as a permanent alias for whatever the current version is: handy for a quick curl, wrong to pin an integration to. Inside a version, changes are additive only: new endpoints, new optional parameters, new response fields. A field is never removed, renamed or retyped, and a code in `error` is never repurposed. A breaking change ships as a new prefix (`/v2`) served alongside the old one. When a version begins winding down, every response from it carries `Deprecation: true` (RFC 9745) and `Sunset: <HTTP-date>` (RFC 8594); the date it stops answering, never less than six months out, plus a `Link` header with `rel="successor-version"`. `X-API-Version` names the serving version on every response. ## Rate limits Public callers get 600 requests per 60 seconds. Every response carries `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (seconds until the window rolls) and `RateLimit-Policy`, so a client can pace itself instead of discovering the ceiling. A refused request answers **429** with `Retry-After`. ## Errors Every failure (a bad parameter, an unknown path, a fault on our side) returns JSON with the same fields: `error` (a stable machine-readable code), `message` (prose), `hint` (what to change) and `docs` (where to read more). Codes: `invalid_request`, `unauthorized`, `forbidden`, `not_found`, `rate_limited`, `internal_error`.
- [Fractions](/api/reference/fractions): Metadata for the tokenised coins. Everything about value lives on chain; this only says what a token id means.
- [Issuers](/api/reference/issuers): Issuing authorities, as Numista's tree, and the series filed under them.
- [Mints](/api/reference/mints): Who struck the coins, and the series they strike.
- [Rates](/api/reference/rates): The USD conversion table melt values are rendered with.
- [Sitemap](/api/reference/sitemap): Bulk, cheap enumeration of every catalogue entity that has a page: identity and last-modified date only.
- [Spot](/api/reference/spot): The gold price melt values are computed from.
- [Types](/api/reference/types): The unit of the catalogue: one design at one denomination and composition, with its issues.
- [Wallet](/api/reference/wallet): The signed-in player's embedded wallet. Holds no key and moves no money: signing happens in the browser, against Openfort.