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 Spot prices for Gold (XAU), Silver (XAG), Platinum (XPT) and Palladium (XPD) — near real-
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 6.3 and PHP 7.4.
SourceWordPress plugins · Oct 30, 2026
01 / Source details
Aboutthistool.
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
Spot prices for Gold (XAU), Silver (XAG), Platinum (XPT) and Palladium (XPD) — near real-time on paid plans, delayed on the Free plan
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)
Sidebar widget — classic widget for the metals ticker
Server-side only — your API key stays on the server, never exposed to the browser
Smart, plan-aware caching — one shared request per page, 6-hour cache on the Free plan, last known prices shown if the API is unreachable
Plan & usage box — see your monthly request usage in Settings → MetalflowAPI, with a warning at 80% and 100%
Interactive history chart — 7D / 1M / 6M / 1Y / 5Y / Max range buttons, price and date axes, hover/keyboard tooltip, responsive, no external JavaScript libraries (paid plans; ranges follow your plan’s history depth)
Theme-adaptive by default — widgets inherit your theme’s font, text and link colours (theme.json presets) and adapt to dark themes and dark backgrounds
Easy customisation — global Appearance settings (style preset card / minimal / borderless, accent, text, background, border, up/down colours, corner radius, text size) with live preview; per-block colour, typography, spacing and border controls; shortcode attributes
Optional “Powered by” bonus — off by default. If you choose to show a small “Prices by MetalflowAPI” link (once per page), Free-plan sites get 2,000 requests/month instead of 500 and fresher prices once the link is verified
Translation-ready — all strings localized
Shortcodes
[metalflow_price metal="Gold" currency="EUR" unit="g"] — spot price for one metal [metalflow_carat carat="14" currency="EUR" unit="g"] — carat-aware Gold price [metalflow_ticker currency="EUR" unit="g" style="minimal"] — all 4 metals [metalflow_table currency="EUR" unit="g"] — full carat table 9k–24k [metalflow_change metal="Gold" days="30"] — % change over N days (Starter and above) [metalflow_calc currency="EUR"] — interactive carat-weight calculator [metalflow_chart metal="Gold" currency="EUR" range="1y" ranges="7d,1m,6m,1y,5y,max"] — interactive history chart with range buttons (paid plans)
Chart attributes
range — default range: 7d , 1m , 6m , 1y , 5y or max (default from Settings, normally 1y ; older values such as 30d , 90d , 2y still work)
ranges — which buttons to show, comma separated (default from Settings)
metal , currency , unit ( g , kg , ozt ), height (80–600 px, default 220), fill="0" (no area fill), label="0" (hide title/price/change header)
Ranges longer than your plan’s history (Free 30 days, Starter 5 years, Pro 30 years) are hidden from visitors; administrators see them with a lock and a link to the plans. The default range is rendered with the page; other ranges load on click from your own site ( /wp-json/metalflowapi/v1/chart , which only serves charts that appear on your site, from the server-side cache).
Styling attributes (all shortcodes)
style — card , minimal or borderless
color (or accent ) — accent / chart line colour, e.g. color="#b8860b"
text , bg , border — text, background and border colours (hex)
up , down — colours for rising / falling prices (hex)
radius — corner radius in px (0–32)
size — text size scale (0.75–1.5)
Example: [metalflow_ticker style="minimal" color="#b8860b"] , [metalflow_chart range="1m" style="borderless" color="#2563eb" radius="12"] . Invalid values are ignored. Without attributes, widgets use Settings → MetalflowAPI → Appearance, and with that left empty they follow your theme.
Pricing
The plugin is 100% free . Prices come from the MetalflowAPI service, which has a free tier (no credit card required):
Free — personal & non-commercial sites only. 500 requests/month, delayed prices , 10 currencies, 30-day history. The price change and chart widgets are not included (they stay hidden from visitors).
Pro — €29/mo, 100,000 requests, 30-year history, all currencies.
Enterprise — custom, full 1968+ history.
Current plans: metalflowapi.com/pricing
EU & GDPR
Servers in Strasbourg (France). All data within EU. GDPR-compliant. EUR billing with VAT invoices.
External services
This plugin connects to the MetalflowAPI service (metalflowapi.com, operated by MetalflowAPI) to fetch precious metals prices. It is required for live data; without an API key the plugin makes no requests at all. Terms of Service: https://metalflowapi.com/legal/terms · Privacy Policy: https://metalflowapi.com/legal/privacy
Price data (only after you add or register an API key). Requests are made from your WordPress server — never from your visitors’ browsers — when a page with a MetalflowAPI shortcode, block or widget is rendered and the cached copy has expired, and when you click “Test connection”. Endpoints:
https://metalflowapi.com/api/v1/latest — spot prices (shortcodes metalflow_price , metalflow_ticker , the Live Price/Ticker blocks and the ticker widget)
https://metalflowapi.com/api/v1/carat — gold carat prices ( metalflow_carat , metalflow_table , metalflow_calc and the carat blocks)
https://metalflowapi.com/api/v1/timeframe — daily prices for the 7D, 1M, 6M and 1Y chart ranges ( metalflow_chart , Historical Chart block)
https://metalflowapi.com/api/v1/sparkline — long-range price curve for the 5Y and Max chart ranges (also used if your plan does not include /timeframe )
https://metalflowapi.com/api/v1/symbols — key check and currency list on the settings page
Sent with each request: your API key ( X-API-Key header), the query parameters needed for the widget (metal, currency, unit, date range, chart size/colour) and a User-Agent with the plugin and WordPress version numbers (it does not contain your site address). Your server’s IP address is visible to the service, as with any HTTP request. Nothing about your visitors (IP addresses, cookies, behaviour), posts, comments or users is sent.
Optional in-dashboard registration (Settings → MetalflowAPI → “Get your free API key”). Only when you type your email address and click “Send code”, the plugin sends that email address, this site’s URL and the plugin version to https://metalflowapi.com/api/plugin/request-code . When you enter the 6-digit code it sends your email address and the code to https://metalflowapi.com/api/plugin/verify-code . This creates your free MetalflowAPI account and returns your API key, which is saved in your site’s WordPress options.
Optional “Powered by MetalflowAPI” bonus (off by default). Only after you tick “Show a ‘Powered by MetalflowAPI’ link…” in Settings → MetalflowAPI and save (or click “Register this site”), the plugin sends this site’s address (home URL), the address of one public page of your site that shows a MetalflowAPI widget (if known), the plugin version and your API key ( X-API-Key header) to https://metalflowapi.com/api/plugin/poweredby (POST). MetalflowAPI then loads that homepage/page — right away and about once a day — only to check that the “Prices by MetalflowAPI” link is there; on the Free plan a verified link raises your monthly limit to 2,000 requests and gives fresher prices. The settings page asks the same endpoint for the verification status (GET, at most every 10 minutes while you view the page). When you untick the option, the plugin asks the endpoint to delete the registration (DELETE). Nothing is sent while the option is off.
Chart ranges in the browser. When a visitor clicks a chart range button, the browser asks your own site ( /wp-json/metalflowapi/v1/chart ), not metalflowapi.com. That endpoint only accepts the metal/currency/unit combinations of charts rendered on your site (signed) and the six fixed ranges, answers from the server-side cache (one API request per range per cache period: at least 30 minutes for 7D/1M, 1 hour for 6M/1Y, 6 hours for 5Y/Max) and never exposes your API key.
Caching. Responses are cached on your server with WordPress transients: on the Free plan (delayed prices) for 6 hours (1 hour with an active “Powered by” bonus), on paid plans for the configured time (default 5 minutes, never shorter than the plan’s own refresh interval). Errors are cached briefly (a quota error until the time given by the service), and the last successful response is kept so visitors see the last known price, with its date, while the service is unreachable.
Links. Links to metalflowapi.com in the WordPress admin (sign-up, pricing, dashboard) carry utm_* parameters and the plugin version so MetalflowAPI can see which plugin version a visit came from. Nothing is sent until you click such a link. The optional “Prices by MetalflowAPI” link on the public site is off by default; when you enable it, it is a plain link to metalflowapi.com (the gold price page of your default currency) without tracking parameters, shown once per page.
See it in action
Screenshots & previews.
History chart with 7D–Max range buttons, axes and hover tooltip (Twenty Twenty-Five).The same chart on a dark background — colours adapt automatically.Administrators see ranges beyond the plan with a lock and an upgrade link; visitors never see locked buttons.Style presets: card, minimal and borderless.Custom accent colour via shortcode attributes.Settings → MetalflowAPI → Appearance with colour pickers and live preview.Block inspector: chart settings, range buttons and "Widget style" panel.Carat table and carat-weight calculator.
02 / Source details
Gettingstarted.
01Upload the plugin to /wp-content/plugins/metalflowapi-live-precious-metals-prices/ or install it through the WordPress Plugins screen.
02Activate the plugin.
03Go to Settings → MetalflowAPI , enter your email to get a free key in the dashboard (or paste an existing key from metalflowapi.com/dashboard/keys).
04Click Test connection to verify.
05Drop a shortcode into any post or page, e.g. [metalflow_ticker currency="EUR"] .
03 / Source details
Frequently asked questions.
Do I need a paid plan to use this plugin?
Not for a personal or non-commercial site: the Free plan (500 requests/month, delayed prices) works with the plugin, which caches Free-plan prices for 6 hours to stay within the quota. Commercial sites (shops, jewelers, dealers) need a paid plan under MetalflowAPI’s terms; Starter (€9/mo) also gives fresher prices and the change widget. Settings → MetalflowAPI shows your plan and monthly usage.
What is the “Powered by MetalflowAPI” bonus?
An optional deal, off by default: tick “Show a ‘Powered by MetalflowAPI’ link under widgets…” in Settings → MetalflowAPI and the plugin prints one small “Prices by MetalflowAPI” link per page, under the first widget. Your site is registered with MetalflowAPI, which checks your homepage (or the first public page that shows a widget) for the link right away and then daily. While the link is found, the Free plan gets 2,000 requests/month instead of 500 and fresher prices; the settings page shows the status (pending, verified, link not found). If the link is missing on two checks in a row, the bonus ends. Paid plans can show the link too, but don’t need the bonus. Untick the option to remove the link and the registration at any time.
What happens when my monthly requests run out or the API is down?
Visitors keep seeing the last known prices, labelled “as of “, and the plugin stops calling the API until the time given by the service, so pages stay fast. Administrators see a notice at 80% and 100% of the monthly quota (only on the Dashboard, Plugins and MetalflowAPI settings screens).
Where is my API key stored?
In your WordPress database ( wp_options ). Requests to MetalflowAPI are made from your WordPress server — the key is never sent to visitor browsers.
Does this plugin slow down my site?
No. All API responses are cached server-side via WordPress transients (default 5 min, configurable). On a cache hit, response time is essentially zero.
Can I use this in a multisite / network?
Yes. Each site has its own settings and its own API key.
Does the plugin work without an API key?
Visitors see nothing until a key is added. Logged-in editors see static sample data (labelled “Sample data · only you see this”) so they can place and style widgets. The sample is built into the plugin — no network request is made and nothing is sent anywhere.
Do you support cryptocurrency prices?
Not in v1.0. BTC/ETH support is on the roadmap for the MetalflowAPI service.
Can I customize the styling?
Yes. By default the widgets follow your theme. Settings → MetalflowAPI → Appearance sets a style preset (card, minimal, borderless), colours, corner radius and text size for all widgets, with a live preview. Each block has colour, typography, spacing and border controls plus a “Widget style” panel, and every shortcode accepts style , color , text , bg , border , up , down , radius and size . For full control, the widgets use CSS custom properties on the .mfapi-w wrapper ( --mfapi-accent , --mfapi-text , --mfapi-bg , --mfapi-border , --mfapi-up , --mfapi-down , --mfapi-radius ) and semantic class names ( mfapi-price , mfapi-ticker , mfapi-chart , …).
Why are some chart ranges missing?
Ranges longer than your plan’s history are hidden from visitors (Free: 30 days — the chart itself needs a paid plan; Starter: 5 years; Pro: 30 years; Max is the full archive back to 1968). Logged-in administrators see these buttons with a lock and a link to the plans.
Website LLMs.txt and LLMs-Full.txt Generator is an LLMs.txt generator and llms-full.txt generator for WordPress. It helps site owners generate, manage, preview, validate, and serve AI discovery files from published public content. Use it to create structured /llms.txt and optional /llms-full.txt end
EngageDock AI is a customizable floating contact widget for WordPress websites that want more leads and faster visitor communication. It helps small businesses turn website traffic into calls, texts, emails, and callback requests from one clean contact panel. Key Features: Click-to-Call – One tap ca
Altify AI is an auto ALT text and AI ALT text plugin for WordPress images. It helps generate descriptive image ALT text for accessibility and image SEO. Use bulk image ALT text tools for your Media Library, generate featured image ALT text automatically, and scale WooCommerce image ALT updates with
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati
