API v1 · generally available
Real-time and historical prices for 27 metals, energy and agricultural instruments. One JSON schema, one header, four regions — from a curl to a production feed in an afternoon.
No card required · 10,000 requests / month free · Key issued instantly
$ curl -s https://api.meridian-data.example/v1/commodities/XAU \
-H "Authorization: Bearer $MERIDIAN_API_KEY"
200 OK · 38 ms · application/json
{
"data": {
"symbol": "XAU",
"name": "Gold",
"category": "Metals",
"unit": "USD/oz",
"price": 2412.35,
"change": 18.4,
"changePct": 0.77
},
"meta": {
"request_id": "req_f647c6e17d3ef32c",
"as_of": "2026-10-29T19:02:35.044Z",
"count": 1,
"api_version": "v1"
}
}27
Instruments covered
99.98%
30-day uptime · 99.9% SLA
38 ms
p50 response, global
4
Delivery regions
Built for
Screens need speed. Risk needs an audit trail. Products need an integration that does not page you at 3am. One API contract serves all three.
Replace three vendor terminals and a spreadsheet with a single normalised feed. Pull the last, the session range and the curve into your blotter, then push fills against a price your risk system already trusts.
Every response carries an as-of timestamp and a request id, so a limit breach can be reconstructed months later. Backfill a decade of closes without asking a vendor for a CSV.
A JSON API with one header, predictable errors and no SOAP. Start on the free tier, keep the same request shape in production, and scale the key rather than the integration.
Coverage
Every instrument returns the same fields — symbol, name, category, unit, last, change and percentage move — so one parser handles gold, Brent and cocoa without a lookup table.
Edge latency
Infrastructure
Meridian is not a scraper with a JSON wrapper. Venue feeds land in London and Geneva, get mapped to a single instrument model, and are served from read-only replicas in four regions.
One symbol per instrument, stable across venues and contract months. No vendor-specific codes leaking into your codebase.
Every payload carries an as-of time and request id. Reproduce any valuation months later without a support ticket.
Traffic is routed to the nearest healthy edge. Enterprise keys can pin to a region or run private endpoints.
Pricing
Every plan gets the full instrument list and the same v1 contract. Upgrade for real-time values, history and a latency SLA.
Build and evaluate against the full coverage set. No card, no expiry.
$0 per month
10,000 requests / month
Start freeProduction workloads with real-time snapshots and a latency SLA.
$249 per month
2,000,000 requests / month
Start Pro trialContractual guarantees, private routing and full history on demand.
$1,490 per month
Unlimited, contract-priced
Talk to salesPrices in USD, billed monthly. Cancel any time. Free tier is non-commercial; see terms.
Quickstart
No SDK required, though the shape is boring enough to wrap in ten lines. Every endpoint is a cacheable GET and returns JSON with a request id.
curl -s https://api.meridian-data.example/v1/commodities/XAU \
-H "Authorization: Bearer $MERIDIAN_API_KEY" \
-H "Accept: application/json"
# 200 OK
{
"data": {
"symbol": "XAU",
"name": "Gold",
"category": "Metals",
"unit": "USD/oz",
"price": 2412.35,
"change": 18.4,
"changePct": 0.77
},
"meta": {
"request_id": "req_8f2c41d0a7b94e13",
"as_of": "2026-10-29T09:14:02Z",
"api_version": "v1"
}
}const res = await fetch(
"https://api.meridian-data.example/v1/commodities?category=Energy",
{
headers: {
Authorization: `Bearer ${process.env.MERIDIAN_API_KEY}`,
Accept: "application/json",
},
}
);
if (!res.ok) throw new Error(`Meridian ${res.status}`);
const { data, meta } = await res.json();
console.log(meta.request_id, data.map((c) => c.symbol).join(", "));import os, requests
res = requests.get(
"https://api.meridian-data.example/v1/commodities",
params={"category": "Metals", "limit": 10},
headers={"Authorization": f"Bearer {os.environ['MERIDIAN_API_KEY']}"},
timeout=5,
)
res.raise_for_status()
payload = res.json()
for instrument in payload["data"]:
print(instrument["symbol"], instrument["price"], instrument["unit"])The key above is a placeholder. Issue a real one and the example is printed ready to paste.
All systems operational
API v1 · 90-day historyNo. The free key is issued instantly, has no expiry and does not require billing details. It is limited to 10,000 requests a month and non-commercial use.
Pro and Enterprise keys receive snapshots refreshed every second during the session. Free keys receive 15-minute delayed values plus end-of-day closes. Every response includes an as-of timestamp you can audit.
The API returns HTTP 429 with a Retry-After header and a rate_limit error body. Requests are never silently dropped. Monthly quota resets on the first of the month, UTC.
Yes, on Pro and Enterprise. The free tier is for evaluation and non-commercial projects. Redistribution of raw values requires an Enterprise agreement.
Four regions: London, Frankfurt, Virginia and Singapore. Keys are region-agnostic; pin traffic to a region on Enterprise. All traffic is TLS 1.3 with HSTS.
No. Meridian Data is a fictional product built for demonstration. Prices are deterministic, fabricated snapshots and must not be used for valuation, settlement or trading decisions.
Free key, full coverage, 10,000 requests a month. No card, no sales call.
Indicative data & privacy notice. This site sets no advertising or analytics cookies and loads nothing from third parties. It stores a single preference in your browser only if you dismiss this notice. Prices are fictional snapshots, not executable quotes, and nothing here is investment advice. Privacy · Terms