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 des prix de l’or en direct

Prix de l’or en temps réel, un seul appel API.

1 · Votre application

◆

2 · Grams API

XAU 4,219.72
XAG 53.40

3 · JSON en direct

1 Envoyez une requête avec votre clé API 2 Nous récupérons le flux de marché en direct 3 JSON instantané — dans n’importe quelle devise

5Métaux

14+Devises

<100msTemps de réponse

99.9%Disponibilité

Tout ce qu’il faut pour évaluer les métaux

Une API REST simple et sécurisée — sans SDK, juste une clé 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": { … } }

Prix en temps réel pour 5 métaux

Or, argent, platine, palladium et cuivre — directement depuis notre flux de marché en direct, mis à jour en continu côté serveur.

Once + au gramme (24k/22k/21k/18k)
Variation quotidienne et pourcentage
Réponses en cache en moins d’une seconde

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

N’importe quelle devise, unité ou carat

Convertissez les poids en valeur instantanément dans plus de 14+ devises. Grammes, onces ou kilos — carats d’or inclus.

USD · SAR · AED · KWD · QAR · BHD …
unités 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

Conçu pour l’échelle et sécurisé par clé

Chaque requête est authentifiée par votre clé API et régie par des en-têtes transparents de limite de débit et de quota. Suivez l’utilisation en direct dans votre tableau de bord.

Limites de débit par minute
Quotas mensuels et graphiques d’utilisation
Révoquez / renouvelez les clés à tout moment

Utilisez-la avec votre langage favori

Des extraits prêts à copier-coller pour chaque stack populaire — sans SDK, juste un appel HTTP.

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

Une tarification simple et flexible

Commencez gratuitement. Évoluez quand vous grandissez. Annulez à tout moment.

Free

$0 /month

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

Commencer gratuitement

Popular

Black Friday Mega Deal

$9 /month

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

Choisir

Ultimate

$129 /month

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

Choisir

Documentation de l’API

URL de base https://grams.today/v1 — chaque endpoint est GET et renvoie du JSON.

🔐 Authentification

Tous les endpoints nécessitent votre clé API — gardez-la secrète. Envoyez-la de trois façons :

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 — tous les métaux. GET /v1/gold — or uniquement.

GET /v1/convert — valeur d’une quantité. Paramètres : metal, weight, unit (g/oz/kg), karat, currency.

GET /v1/historical — historique quotidien. Paramètres : metal, days, currency. GET /v1/symbols — métaux et devises pris en charge.

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

Limites de débit

`X-RateLimit-Limit`	requêtes / minute selon votre plan
`X-Quota-Limit` / `X-Quota-Used`	quota mensuel et utilisation

Dépasser une limite renvoie 429. Les erreurs sont { "success": false, "error": { "code", "message" } } avec 401 (clé), 422 (param. invalide), 429 (limite).

Exemples de code — pour chaque langage populaire

Récupérez le prix de l’or en direct (GET /v1/gold) — changez l’onglet pour votre langage :

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

Obtenez votre clé API →