What is the Grams Gold Price API?

A REST API that returns real-time gold, silver, platinum and palladium prices as JSON in any supported currency.

Is there a free Gold Price API plan?

Yes — a free plan with 5,000 requests per month. Upgrade anytime.

How do I get a gold API key?

Create a free account, then generate your key in the developer dashboard.

Which metals and currencies are supported?

Gold, silver, platinum, palladium and copper, in 10+ currencies.

API de precios del oro en vivo

Precios del oro en tiempo real, una sola llamada API.

1 · Tu app

◆

2 · Grams API

XAU 4,219.72
XAG 53.40

3 · JSON en vivo

1 Envía una solicitud con tu clave API 2 Obtenemos el flujo de mercado en vivo 3 JSON instantáneo — en cualquier moneda

5Metales

14+Monedas

<100msTiempo de respuesta

99.9%Tiempo activo

Todo lo que necesitas para valorar metales

Una API REST simple y segura — sin SDK, solo una clave API.

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": { … } }

Precios en tiempo real para 5 metales

Oro, plata, platino, paladio y cobre — directamente de nuestro flujo de mercado en vivo, actualizado continuamente en el servidor.

Onza + por gramo (24k/22k/21k/18k)
Cambio diario y porcentaje
Respuestas en caché en menos de un segundo

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" }

Cualquier moneda, cualquier unidad, cualquier quilate

Convierte pesos a valor al instante en más de 14+ monedas. Gramos, onzas o kilos — incluye quilates de oro.

USD · SAR · AED · KWD · QAR · BHD …
unidades g / oz / kg
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

Diseñada para escalar y protegida por clave

Cada solicitud se autentica con tu clave API y se rige por cabeceras transparentes de límite de tasa y cuota. Sigue el uso en vivo en tu panel.

Límites de tasa por minuto
Cuotas mensuales y gráficos de uso
Revoca / rota claves en cualquier momento

Úsala con tu lenguaje favorito

Fragmentos listos para copiar y pegar para cada stack popular — sin SDK, solo una llamada HTTP.

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

Precios simples y flexibles

Empieza gratis. Mejora cuando escales. Cancela cuando quieras.

Free

$0 /month

Real-time Gold Price
Multi-Currency Support
100 calls / month

Empezar gratis

Popular

Black Friday Mega Deal

$9 /month

Real-time Gold Price
Multi-Currency Support
Unlimited API Call
Single Server Configuration

Elegir plan

Ultimate

$129 /month

Real-time Gold Price
Multi-Currency Support
Live Support
Unlimited API Call

Elegir plan

Documentación de la API

URL base https://grams.today/v1 — cada endpoint es GET y devuelve JSON.

🔐 Autenticación

Todos los endpoints requieren tu clave API — mantenla en secreto. Envíala de tres formas:

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 — todos los metales. GET /v1/gold — solo oro.

GET /v1/convert — valor de una cantidad. Parámetros: metal, weight, unit (g/oz/kg), karat, currency.

GET /v1/historical — historial diario. Parámetros: metal, days, currency. GET /v1/symbols — metales y monedas admitidos.

{ "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": { … } } }

Límites de tasa

`X-RateLimit-Limit`	solicitudes / minuto en tu plan
`X-Quota-Limit` / `X-Quota-Used`	cuota mensual y uso

Superar un límite devuelve 429. Los errores son { "success": false, "error": { "code", "message" } } con 401 (clave), 422 (parámetro inválido), 429 (límite).

Ejemplos de código — para cada lenguaje popular

Obtén el precio del oro en vivo (GET /v1/gold) — cambia la pestaña a tu lenguaje:

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);

Obtén tu clave API →