ما هي API أسعار الذهب من Grams؟

واجهة REST تُعيد أسعار الذهب والفضة والبلاتين والبلاديوم الفورية بصيغة JSON بأي عملة مدعومة.

هل توجد خطة مجانية؟

نعم، خطة مجانية مع 5000 طلب شهريًا. يمكنك الترقية في أي وقت.

كيف أحصل على مفتاح API؟

أنشئ حسابًا مجانيًا ثم ولّد مفتاحك من لوحة المطورين.

ما المعادن والعملات المدعومة؟

الذهب والفضة والبلاتين والبلاديوم والنحاس، بأكثر من 10 عملات.

واجهة أسعار الذهب المباشرة

أسعار الذهب في الوقت الفعلي، باستدعاء API واحد.

1 · تطبيقك

◆

2 · Grams API

XAU 4,219.72
XAG 53.40

3 · JSON مباشر

1 أرسل طلباً باستخدام مفتاح API الخاص بك 2 نسحب بيانات السوق المباشرة 3 JSON فوري — بأي عملة

5معادن

14+عملات

<100msزمن الاستجابة

99.9%مدة التشغيل

كل ما تحتاجه لتسعير المعادن

واجهة REST API واحدة بسيطة وآمنة — دون الحاجة إلى أي SDK، فقط مفتاح 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": { … } }

أسعار في الوقت الفعلي لخمسة معادن

الذهب والفضة والبلاتين والبلاديوم والنحاس — مباشرةً من بيانات السوق المباشرة لدينا، محدّثة باستمرار على الخادم.

الأونصة + لكل غرام (24k/22k/21k/18k)
التغير اليومي والنسبة المئوية
استجابات مخزّنة مؤقتاً بأقل من ثانية

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

أي عملة، أي وحدة، أي عيار

حوّل الأوزان إلى قيمة فوراً بأكثر من 14+ عملة. غرامات أو أونصات أو كيلوغرامات — مع عيارات الذهب.

USD · SAR · AED · KWD · QAR · BHD …
وحدات غ / أونصة / كغ
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

مبنية للتوسّع ومحمية بالمفتاح

يتم التحقق من كل طلب بمفتاح API الخاص بك ويخضع لرؤوس شفافة لحدود المعدل والحصة. تتبّع الاستخدام مباشرةً من لوحة التحكم.

حدود معدل لكل دقيقة
حصص شهرية ورسوم بيانية للاستخدام
إلغاء / تدوير المفاتيح في أي وقت

استخدمها مع لغتك المفضلة

مقتطفات جاهزة للنسخ لكل بيئة شائعة — دون الحاجة إلى SDK، فقط استدعاء HTTP واحد.

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

تسعير بسيط ومرن

ابدأ مجاناً. قم بالترقية عند التوسّع. ألغِ في أي وقت.

Free

$0 /month

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

ابدأ مجاناً

Popular

Black Friday Mega Deal

$9 /month

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

اختر الخطة

Ultimate

$129 /month

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

اختر الخطة

توثيق API

عنوان URL الأساسي https://grams.today/v1 — كل نقطة نهاية هي GET وتُرجع JSON.

🔐 المصادقة

تتطلب جميع نقاط النهاية مفتاح API الخاص بك — احتفظ به سرياً. أرسله بثلاث طرق:

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"

نقاط النهاية

GET /v1/prices — جميع المعادن. GET /v1/gold — الذهب فقط.

GET /v1/convert — قيمة كمية معينة. المعاملات: metal, weight, unit (g/oz/kg), karat, currency.

GET /v1/historical — السجل اليومي. المعاملات: metal, days, currency. GET /v1/symbols — المعادن والعملات المدعومة.

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

حدود المعدل

`X-RateLimit-Limit`	الطلبات / الدقيقة حسب خطتك
`X-Quota-Limit` / `X-Quota-Used`	الحصة الشهرية والاستخدام

تجاوز الحد يُرجع 429. الأخطاء بصيغة { "success": false, "error": { "code", "message" } } مع 401 (المفتاح), 422 (معامل خاطئ), 429 (الحد).

أمثلة برمجية — لكل لغة شائعة

احصل على سعر الذهب المباشر (GET /v1/gold) — بدّل التبويب إلى لغتك:

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

احصل على مفتاح API →