Live Gold Price API

Real-time gold prices, one API call.

$
1 · Your app
◆
2 · Grams API
XAU 4,219.72
XAG 53.40
3 · Live JSON
1 Send a request with your API key 2 We pull the live market feed 3 Instant JSON — in any currency
5Metals
14+Currencies
<100msResponse time
99.9%Uptime

Everything you need to price metal

One simple, secure REST API — no SDKs required, just an API key.

curl "https://grams.today/v1/prices?currency=USD" \ -H "Authorization: Bearer YOUR_API_KEY"
import requests res = requests.get( "https://grams.today/v1/prices?currency=USD", headers={"Authorization": "Bearer YOUR_API_KEY"}, ) print(res.json())
const res = await fetch("https://grams.today/v1/prices?currency=USD", { headers: { Authorization: "Bearer YOUR_API_KEY" }, }); const data = await res.json(); console.log(data);
$ch = curl_init("https://grams.today/v1/prices?currency=USD"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer YOUR_API_KEY", ]); $data = json_decode(curl_exec($ch), true); print_r($data);
require "net/http" require "json" uri = URI("https://grams.today/v1/prices?currency=USD") req = Net::HTTP::Get.new(uri) req["Authorization"] = "Bearer YOUR_API_KEY" res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) } puts JSON.parse(res.body)
req, _ := http.NewRequest("GET", "https://grams.today/v1/prices?currency=USD", nil) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body))
HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://grams.today/v1/prices?currency=USD")) .header("Authorization", "Bearer YOUR_API_KEY") .build(); HttpResponse<String> res = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(res.body());
using var client = new HttpClient(); client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY"); string json = await client.GetStringAsync("https://grams.today/v1/prices?currency=USD"); Console.WriteLine(json);
// response { "XAU": { "ounce": 4219.72, "gram_24k": 134.27 }, "XAG": { "ounce": 53.4 }, "XPT": { … } }

Real-time prices for 5 metals

Gold, silver, platinum, palladium and copper — straight from our live market feed, updated continuously server-side.

  • Ounce + per-gram (24k/22k/21k/18k)
  • Daily change & percentage
  • Sub-second cached responses
curl "https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR" \ -H "Authorization: Bearer YOUR_API_KEY"
import requests res = requests.get( "https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR", headers={"Authorization": "Bearer YOUR_API_KEY"}, ) print(res.json())
const res = await fetch("https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR", { headers: { Authorization: "Bearer YOUR_API_KEY" }, }); const data = await res.json(); console.log(data);
$ch = curl_init("https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer YOUR_API_KEY", ]); $data = json_decode(curl_exec($ch), true); print_r($data);
require "net/http" require "json" uri = URI("https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR") req = Net::HTTP::Get.new(uri) req["Authorization"] = "Bearer YOUR_API_KEY" res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) } puts JSON.parse(res.body)
req, _ := http.NewRequest("GET", "https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR", nil) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body))
HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR")) .header("Authorization", "Bearer YOUR_API_KEY") .build(); HttpResponse<String> res = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(res.body());
using var client = new HttpClient(); client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY"); string json = await client.GetStringAsync("https://grams.today/v1/convert?metal=XAU&weight=10&unit=g&karat=22&currency=SAR"); Console.WriteLine(json);
// response { "value": 4663.56, "currency": "SAR" }

Any currency, any unit, any karat

Convert weights to value instantly in 14+ currencies. Grams, ounces or kilos — gold karats included.

  • USD · SAR · AED · KWD · QAR · BHD …
  • g / oz / kg units
  • 24k · 22k · 21k · 18k
curl "https://grams.today/v1/gold?currency=USD" \ -H "Authorization: Bearer YOUR_API_KEY"
import requests res = requests.get( "https://grams.today/v1/gold?currency=USD", headers={"Authorization": "Bearer YOUR_API_KEY"}, ) print(res.json())
const res = await fetch("https://grams.today/v1/gold?currency=USD", { headers: { Authorization: "Bearer YOUR_API_KEY" }, }); const data = await res.json(); console.log(data);
$ch = curl_init("https://grams.today/v1/gold?currency=USD"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer YOUR_API_KEY", ]); $data = json_decode(curl_exec($ch), true); print_r($data);
require "net/http" require "json" uri = URI("https://grams.today/v1/gold?currency=USD") req = Net::HTTP::Get.new(uri) req["Authorization"] = "Bearer YOUR_API_KEY" res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) } puts JSON.parse(res.body)
req, _ := http.NewRequest("GET", "https://grams.today/v1/gold?currency=USD", nil) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body))
HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://grams.today/v1/gold?currency=USD")) .header("Authorization", "Bearer YOUR_API_KEY") .build(); HttpResponse<String> res = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(res.body());
using var client = new HttpClient(); client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY"); string json = await client.GetStringAsync("https://grams.today/v1/gold?currency=USD"); Console.WriteLine(json);
// response headers X-RateLimit-Limit: 1200 · X-Quota-Used: 4187

Built for scale & secured by key

Every request is authenticated with your API key and governed by transparent rate-limit & quota headers. Track usage live in your dashboard.

  • Per-minute rate limits
  • Monthly quotas & usage charts
  • Revoke / rotate keys anytime

Use it with your favorite language

Copy-paste snippets for every popular stack — no SDK required, just one HTTP call.

>_ cURLcommand line Py Pythonrequests JS JavaScriptfetch / Node php PHPcURL Rb Rubynet/http Go Gonet/http Jv JavaHttpClient C# C#.NET

Simple, flexible pricing

Start free. Upgrade when you scale. Cancel anytime.

Free

$0 /month
  • Real-time Gold Price
  • Multi-Currency Support
  • 100 calls / month
Get started free
Popular

Black Friday Mega Deal

$9 /month
  • Real-time Gold Price
  • Multi-Currency Support
  • Unlimited API Call
  • Single Server Configuration
Choose Plan

Ultimate

$129 /month
  • Real-time Gold Price
  • Multi-Currency Support
  • Live Support
  • Unlimited API Call
Choose Plan

API Documentation

Base URL https://grams.today/v1 — every endpoint is GET and returns JSON.

🔐 Authentication

All endpoints require your API key — keep it secret. Send it three ways:

curl "https://grams.today/v1/prices" -H "Authorization: Bearer YOUR_API_KEY" curl "https://grams.today/v1/prices" -H "X-API-Key: YOUR_API_KEY" curl "https://grams.today/v1/prices?api_key=YOUR_API_KEY"

Endpoints

GET /v1/prices — all metals. GET /v1/gold — gold only.

GET /v1/convert — value of a quantity. Params: metal, weight, unit (g/oz/kg), karat, currency.

GET /v1/historical — daily history. Params: metal, days, currency. GET /v1/symbols — supported metals & currencies.

{ "success": true, "base_currency": "SAR", "metals": { "XAU": { "ounce": 15823.95, "gram_24k": 508.75, "gram_22k": 466.36, "change": 123.8, "change_percent": 0.78 }, "XAG": { … }, "XPT": { … }, "XPD": { … } } }

Rate limits

X-RateLimit-Limitrequests / minute on your plan
X-Quota-Limit / X-Quota-Usedmonthly quota & usage

Over a limit returns 429. Errors are { "success": false, "error": { "code", "message" } } with 401 (key), 422 (bad param), 429 (limit).

Code examples — every popular language

Fetch the live gold price (GET /v1/gold) — switch the tab to your language:

curl "https://grams.today/v1/gold?currency=USD" \ -H "Authorization: Bearer YOUR_API_KEY"
import requests res = requests.get( "https://grams.today/v1/gold?currency=USD", headers={"Authorization": "Bearer YOUR_API_KEY"}, ) print(res.json())
const res = await fetch("https://grams.today/v1/gold?currency=USD", { headers: { Authorization: "Bearer YOUR_API_KEY" }, }); const data = await res.json(); console.log(data);
$ch = curl_init("https://grams.today/v1/gold?currency=USD"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer YOUR_API_KEY", ]); $data = json_decode(curl_exec($ch), true); print_r($data);
require "net/http" require "json" uri = URI("https://grams.today/v1/gold?currency=USD") req = Net::HTTP::Get.new(uri) req["Authorization"] = "Bearer YOUR_API_KEY" res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) } puts JSON.parse(res.body)
req, _ := http.NewRequest("GET", "https://grams.today/v1/gold?currency=USD", nil) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body))
HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://grams.today/v1/gold?currency=USD")) .header("Authorization", "Bearer YOUR_API_KEY") .build(); HttpResponse<String> res = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(res.body());
using var client = new HttpClient(); client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY"); string json = await client.GetStringAsync("https://grams.today/v1/gold?currency=USD"); Console.WriteLine(json);

Get your API key →