Worked example using the current reference
2026-10-20 · 10 g × 585/1000 × €117.85/g × (1 − 20/100) = €551.54 · €55.15/g
A buying table, not another retail gold quote
A jeweller, pawnshop or specialist gold buyer needs a different number from a shop selling a finished ring. A retail price can reflect workmanship, design, stones and the seller’s terms. A scrap-gold buying reference starts with the gold content of the material and then applies the buyer’s margin. This widget is made for that buying side: it tells a visitor how your indicative gram price differs between a 375 chain, a 585 ring and a 750 bracelet.
It fits a Goldankauf page in Germany, a compro oro business in Italy or Spain, a Polish skup złota shop and a French rachat d’or counter. The labels can also be shown in Lithuanian or English. Choose the language your customers read and the currency in which you pay. Changing the language does not convert an existing contract into another jurisdiction’s terms, so keep your own buying conditions alongside the table.
How the indicative buy price is calculated
The formula for one gram of alloy is fine-gold price per gram × fineness / 1,000 × (1 − margin / 100). A 585 stamp therefore supplies the factor 0.585, while 750 supplies 0.750. The margin is a deduction from the fine-metal content value, not an addition to it. You can set it from 0% to 60%, in steps of one tenth of a percentage point. The same margin applies to each selected row, making the relationship between grades consistent.
For an explicitly illustrative example, suppose fine gold is EUR 100 per gram and the margin is 20%. Ten grams of 585 alloy contain 10 × 0.585 = 5.85 grams of fine gold. Their metal-content value is EUR 585; applying the margin gives EUR 468, or EUR 46.80 per alloy gram. EUR 100 is an example assumption, not today’s quote. The reference calculation on this page uses the returned price rather than this demonstration.
Why separate rows by fineness
Customers often recognise a stamp before they recognise a karat label. Showing both 585 and 14 k, or 750 and 18 k, lets them match the reference to the object in their hand. Include only the grades relevant to your shop. A German preset includes 333, whereas a Polish preset includes both 333 and 375. The list is a configurable material reference, not proof that a stamp is genuine or that a particular article satisfies a national hallmarking requirement.
Keep the unit explicit. Gram pricing is useful for small jewellery lots; a troy-ounce row uses 31.1034768 grams, not an ordinary household ounce. A price for one gram of 585 alloy must not be compared directly with the fine-gold gram price. Neither should a customer multiply an already purity-adjusted buying row by the fineness a second time. Explain which accepted weight your final offer will use.
Free reference or live white-label prices
The free widget uses the daily price from the previous completed UTC day, cached for six hours. Its date and “24 h delayed” label stay visible. It is a reference, not a current executable market quote. The widget includes Gold price by MetalflowAPI, and the free iframe snippet adds the same visible link directly beneath the frame on your website. The script version inserts both the frame and that credit into your page. A link inside a frame alone is not a link in the surrounding website’s HTML.
Live white-label uses your shop’s Starter-or-higher MetalflowAPI key. Starter costs EUR 9/month, has a seven-day free trial, refreshes prices every ten minutes and supports 30 currencies. Pro refreshes every minute. The API is REST only, not a websocket feed. The MetalflowAPI Free API plan has 100 requests per month and prices delayed 24 hours; do not confuse that plan’s quota with a paid shop key or with the public widget’s shared reference cache.
Your key and your request quota
Enter your shop key in the password field for live setup. It is sent to our server for validation, then encrypted into an opaque token in your embed code. The raw key is not placed in the iframe URL or saved in browser storage. Only our server decrypts the token to fetch your prices. Treat the finished token as access to your widget, and share it only on pages where you intend to use that service. Replacing our underlying encryption secret invalidates existing tokens.
Live requests use your own API quota. With the Starter ten-minute cache, continuous use can reach approximately 4,500 requests per month for each currency. Reusing the same token shares that cache; generating separate tokens can increase consumption. This is an estimate of widget requests, not a promise about a plan’s included quota. If you set Allowed Origins on the API key, it must still work for server requests. Confirm that the selected currency is allowed before installing the code.
An indicative price is not a final offer
The final payout follows testing and weighing. Stones, pearls, steel springs, fillings and other non-gold parts should not be included as gold alloy weight. A hallmark can help identify a grade but does not replace your material checks. A designer piece or an antique may deserve a resale assessment rather than a scrap calculation. The widget does not make those judgments and should not be described as a guaranteed purchase commitment.
If paid access is rejected, the currency is not allowed or the plan is downgraded to Free, the widget falls back to the delayed reference and restores visible attribution. Check the displayed date rather than assuming a no-branding installation can never revert. Missing data appears as a dash instead of zero. Place your opening hours, testing procedure and written offer conditions outside the widget so customers can decide whether to bring an item in.
Free vs Live
| Version | Price reference | Branding |
|---|---|---|
| Free | Previous completed UTC day · 24 h delayed | Visible MetalflowAPI link |
| Live | Starter: every 10 min; Pro: every 1 min | No branding with a valid paid key |
Live prices every 10 minutes and no branding – MetalflowAPI Starter, EUR 9/month, 7-day free trial
Start your free trialFrequently asked questions
- Is the free gold buyer widget live?
- No. It uses the daily reference from the previous completed UTC day, cached six hours and visibly labelled 24 h delayed. It includes a MetalflowAPI credit in the frame and in the free host-page snippet.
- How do you apply the shop margin?
- Payout per gram equals fine-gold price per gram × fineness/1,000 × (1 − margin/100). At an illustrative EUR 100 per fine gram, 585 gold with a 20% margin is EUR 46.80 per alloy gram.
- Which MetalflowAPI plan removes branding?
- A validated Starter-or-higher shop key enables live white-label prices. Starter is EUR 9/month with a seven-day free trial, ten-minute refresh and 30 currencies. Pro refreshes every minute.
- Will customers see my API key?
- No. The key is validated and encrypted on our server. The embed uses an opaque token, not the raw key, and the key is not saved in browser storage. Treat the token as access to your widget.
- How many requests will the live widget use?
- Requests count against the shop’s own quota. Continuous Starter use with a ten-minute cache is about 4,500 requests per month per currency; separate tokens may increase requests.
- Is the displayed buy price a binding offer?
- No. It is indicative. Your final offer follows testing, confirmation of fineness and weighing of the accepted gold material. Paid access failures fall back to a credited delayed reference.