The official MetalflowAPI WordPress plugin makes it dead simple to embed live precious metals prices on any WordPress site — perfect for jewelers, publishers, trade-in calculators and bullion shops.
Features
- Live spot prices for Gold (XAU), Silver (XAG), Platinum (XPT) and Palladium (XPD)
- Carat-aware pricing for 9k, 10k, 14k, 18k, 20k, 21k, 22k and 24k Gold
- 30+ currencies — EUR, USD, GBP, JPY, CHF, CAD, AUD, PLN, CZK, INR, BRL, CNY and many more (sourced daily from European Central Bank)
- Units: gram (g), kilogram (kg), troy ounce (ozt)
- 7 shortcodes — drop into any post, page or widget
- 5 Gutenberg blocks — Live Price, Carat Calculator, Ticker, Carat Table, Historical Chart
- Sidebar widget — classic widget for the metals ticker
- REST proxy — your API key stays on the server, never exposed to the browser
- Smart caching — built-in WordPress transient cache (configurable, 30s–24h)
- Theme-aware styling — light and dark themes, follows your site’s typography
- Translation-ready — all strings localized
Shortcodes
[metalflow_price metal="Gold" currency="EUR" unit="g"] — live spot price for one metal
[metalflow_carat carat="14" currency="EUR" unit="g"] — carat-aware Gold price
[metalflow_ticker currency="EUR" theme="light"] — all 4 metals with 24h change
[metalflow_table currency="EUR" unit="g"] — full carat table 9k–24k
[metalflow_change metal="Gold" days="30"] — % change over N days
[metalflow_calc currency="EUR"] — interactive carat-weight calculator
[metalflow_chart metal="Gold" range="1y" currency="EUR" width="600" height="180"] — historical sparkline (30d/90d/180d/1y/2y/5y/10y/30y/max)
Pricing
The plugin is 100% free. The MetalflowAPI service offers a free tier (no credit card required):
- Free — 100 requests/month, daily-refreshed prices, 30-day history
- Starter — €9/mo, 10,000 requests, 10-min refresh, 5-year history
- Pro — €29/mo, 100,000 requests, 1-min refresh, 30-year history
- Enterprise — custom, 15s refresh, full 1968+ history
EU & GDPR
Servers in Strasbourg (France). All data within EU. GDPR-compliant. EUR billing with VAT invoices.
External Service Disclosure
This plugin relies on the MetalflowAPI service (metalflowapi.com) to fetch real-time and historical precious metals prices. By using this plugin you agree to MetalflowAPI's terms of service and privacy policy.
What data is sent to MetalflowAPI from your WordPress server:
- Your API key (passed in the
X-API-KeyHTTP header) — used for authentication and rate-limit tracking. - Query parameters required to fulfil your shortcode/block (metal symbol, currency, date range, etc.).
- The IP address of your WordPress server (standard for any outgoing HTTP request).
What is NOT sent:
- No personally-identifiable information about your site visitors. The plugin never collects, transmits or stores visitor IPs, cookies or browsing behaviour.
- No content of your WordPress posts, comments or user accounts.
Cache: all responses are cached locally on your server via WordPress transients (default 5 minutes, configurable) so the same query does not hit MetalflowAPI repeatedly.
Before you add an API key: the plugin shows built-in static sample data and makes no request to MetalflowAPI. The service is only contacted once a valid API key is saved.
Service endpoints used:
https://metalflowapi.com/wp-json/metals/v1/prices(historical)https://metalflowapi.com/wp-json/metals/v1/live(24h intraday)https://metalflowapi.com/wp-json/metals/v1/all-prices-internal(spot + FX bulk)https://metalflowapi.com/wp-json/metals/v1/sparkline(SVG chart)
Legal:
- Terms of Service: https://metalflowapi.com/legal/terms
- Privacy Policy: https://metalflowapi.com/legal/privacy
