API

The market, machine-readable.

Everything Aureum shows buyers - live dealer prices, effective premiums over spot, real dealer spreads, historical series - served as clean JSON.

What it serves

01

Live offers per product and market, cheapest first, with stock state

02

Sell/buy spreads per dealer, computed consistently across markets and currencies

03

Effective premium over spot per offer, stored at capture, with the VAT class that produced it

04

Historical price and spread series per product, dealer, and market

One response, honestly

GET /v1/countries/DE/products/krugerrand-1oz/prices
Authorization: Bearer <your-api-key>

{
  "data": [
    {
      "captured_at": "2026-07-28T10:32:04Z",
      "country": "DE",
      "currency": "EUR",
      "retailer_code": "example-dealer.de",
      "public_id": "krugerrand-1oz",
      "series_id": "krugerrand",
      "sell_price": 3897.40,
      "buy_price": 3750.50,
      "spread": 146.90,
      "spread_percentage": 3.77,
      "effective_premium_pct": 4.10,
      "vat_status": "free",
      "status": "in_stock",
      "num_offers": 1
    }
  ],
  "next_cursor": null,
  "count": 1
}

Access

Early access: keyed, fair-use rate limits, no self-serve signup yet - tell us what you're building and we'll set you up. Pricing lands with the first partners.

Request a key