MetalflowAPI — Live Precious Metals Prices

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

Sign up free →

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-Key HTTP 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