{"openapi":"3.1.0","info":{"title":"Precious Metals API","version":"1.0.0","description":"Live precious and industrial metal spot prices as an API — gold, silver, platinum, palladium and copper — with optional currency conversion via European Central Bank rates. Get the live USD spot price of any metal and convert it into any major currency; list them all at once; compute the value of a quantity of metal; or read the classic gold/silver and gold/platinum ratios traders watch. Built for trading, jewellery, treasury and dashboard apps. The commodities and precious-metals layer, live and key-free — distinct from generic ticker-quote APIs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/metals-api","description":"oanor gateway"}],"tags":[{"name":"Metals"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Metals"],"summary":"Value of a quantity of metal","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Metal symbol","schema":{"type":"string"},"example":"XAU"},{"name":"amount","in":"query","required":true,"description":"Quantity (in the metal's unit)","schema":{"type":"string"},"example":"2"},{"name":"currency","in":"query","required":false,"description":"Currency","schema":{"type":"string"},"example":"EUR"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Gold","unit":"troy ounce","amount":2,"symbol":"XAU","currency":"EUR","unit_price":3758.8341,"total_value":7517.67},"meta":{"timestamp":"2026-06-09T03:03:24.239Z","request_id":"dbc60e3e-ffd7-4eb5-981e-fa72064499fd"},"status":"ok","message":"Conversion retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Metals"],"summary":"All metals at once","description":"","parameters":[{"name":"currency","in":"query","required":false,"description":"Currency, e.g. EUR","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"metals":[{"name":"Gold","unit":"troy ounce","price":4337.7002,"symbol":"XAU","price_usd":4337.7002,"updated_at":"2026-06-09T03:03:08Z"},{"name":"Silver","unit":"troy ounce","price":67.831,"symbol":"XAG","price_usd":67.831,"updated_at":"2026-06-09T03:03:08Z"},{"name":"Platinum","unit":"troy ounce","price":1765,"symbol":"XPT","price_usd":1765,"updated_at":"2026-06-09T03:03:11Z"},{"name":"Palladium","unit":"troy ounce","price":1247,"symbol":"XPD","price_usd":1247,"updated_at":"2026-06-09T03:03:10Z"},{"name":"Copper","unit":"pound","price":6.2313,"symbol":"HG","price_usd":6.2313,"updated_at":"2026-06-09T03:03:10Z"}],"currency":"USD"},"meta":{"timestamp":"2026-06-09T03:03:24.699Z","request_id":"c584469d-c754-4a7b-b73e-f1d9b72ea068"},"status":"ok","message":"Metals listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/metal":{"get":{"operationId":"get_v1_metal","tags":["Metals"],"summary":"Spot price of a metal","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"XAU | XAG | XPT | XPD | HG (or gold/silver/…)","schema":{"type":"string"},"example":"XAU"},{"name":"currency","in":"query","required":false,"description":"Currency, e.g. EUR","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Gold","unit":"troy ounce","price":4337.7002,"symbol":"XAU","currency":"USD","price_usd":4337.7002,"updated_at":"2026-06-09T03:03:08Z"},"meta":{"timestamp":"2026-06-09T03:03:24.821Z","request_id":"95a6504b-55b2-4641-90b7-11024f0fa7ff"},"status":"ok","message":"Metal spot retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ratio":{"get":{"operationId":"get_v1_ratio","tags":["Metals"],"summary":"Gold/silver and gold/platinum ratios","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Gold/silver ratio = ounces of silver to buy one ounce of gold; a classic relative-value gauge.","gold_usd":4337.7,"silver_usd":67.83,"updated_at":"2026-06-09T03:03:08Z","platinum_usd":1765,"gold_silver_ratio":63.95,"gold_platinum_ratio":2.458},"meta":{"timestamp":"2026-06-09T03:03:24.929Z","request_id":"dee84d21-b9df-4fb3-bfab-24ea578c60aa"},"status":"ok","message":"Ratios retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"metals":[{"name":"Gold","unit":"troy ounce","symbol":"XAU"},{"name":"Silver","unit":"troy ounce","symbol":"XAG"},{"name":"Platinum","unit":"troy ounce","symbol":"XPT"},{"name":"Palladium","unit":"troy ounce","symbol":"XPD"},{"name":"Copper","unit":"pound","symbol":"HG"}],"source":"gold-api.com (spot) + ECB/Frankfurter (FX), live","service":"metals-api","endpoints":{"GET /v1/list":"All metals at once (currency=).","GET /v1/meta":"This document.","GET /v1/metal":"Spot price of a metal (symbol=XAU|XAG|XPT|XPD|HG, currency=USD|EUR|…).","GET /v1/ratio":"Gold/silver and gold/platinum ratios.","GET /v1/convert":"Value of a quantity (symbol=, amount=, currency=)."},"description":"Live precious & industrial metal spot prices (gold, silver, platinum, palladium, copper) from gold-api, with optional currency conversion via ECB rates. Get one metal's spot (in any currency), list all, value a quantity, or read the gold/silver and gold/platinum ratios. Live, no key. Distinct from generic ticker-quote APIs."},"meta":{"timestamp":"2026-06-09T03:03:25.004Z","request_id":"b3426f29-0a35-481e-9eff-adb0145730e6"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":400,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":12000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":58000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5300,"monthly_call_quota":290000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/metals-api"}