واجهة أسعار الذهب للمطورين (API)
أسعار الذهب في السعودية بالريال لكل العيارات، وسعر الأونصة بالدولار والريال، والأسعار التاريخية اليومية، في رد JSON بسيط. مناسبة لمتاجر الذهب، والتطبيقات، وشاشات العرض في المحلات، والمواقع.
البداية
- أنشئ حساباً مجانياً من صفحة التسجيل واحصل على مفتاح تجربة فوراً من «مفاتيح API»، أو تواصل معنا.
- أرسل المفتاح في كل طلب بالترويسة Authorization: Bearer tibr_live_… (أو X-API-Key: tibr_live_…).
- استخدم المفتاح من الخادم (السيرفر) فقط، ولا تضعه في كود يعمل في متصفح الزائر أو داخل تطبيق يمكن فكّه.
- الأسعار تُحدَّث كل 5 دقائق تقريباً، فلا فائدة من الطلب أكثر من مرة في الدقيقة.
curl -H "Authorization: Bearer YOUR_API_KEY" https://tibr.live/api/v1/latest
آخر الأسعار
GET https://tibr.live/api/v1/latest
سعر الجرام بالريال لعيارات 24 و22 و21 و18 و14، وسعر الأونصة، وسعر الصرف، ووقت السعر، وحالة السوق العالمي.
{
"ok": true,
"data": {
"currency": "SAR",
"unit": "gram",
"prices": { "24k": 498.48, "22k": 456.94, "21k": 436.17, "18k": 373.86, "14k": 290.78 },
"ounce": { "usd": 4134.5, "sar": 15504.38 },
"usd_sar": 3.75,
"change_24h": { "24k": 1.48 },
"price_time": "2026-10-09T14:50:12+03:00",
"published_at": "2026-10-09T14:51:04+03:00",
"stale": false,
"market": { "open": true, "reopens_at": null },
"method": "tibr-ref-v1",
"note": "Reference prices excluding workmanship and VAT."
},
"meta": {
"plan": "basic",
"quota": { "monthly_limit": 30000, "used": 1204, "remaining": 28796, "resets": "2026-11-01" },
"docs": "https://tibr.live/developers.php"
}
}
| الحقل | المعنى |
|---|---|
| prices | سعر الجرام بالريال لكل عيار، قبل المصنعية وضريبة القيمة المضافة. |
| ounce | سعر أونصة الذهب (31.1 جرام) بالدولار وبالريال. |
| price_time | وقت السعر في السوق العالمي. published_at وقت نشره في تِبر. |
| stale | true إن تأخر تحديث السعر أكثر من 15 دقيقة والسوق مفتوح. |
| market | السوق العالمي مفتوح أو مغلق (نهاية الأسبوع)، ووقت إعادة الفتح. |
| meta.quota | حد الشهر، والمستهلك، والمتبقي، وتاريخ التجديد. |
الأسعار التاريخية
GET https://tibr.live/api/v1/history?from=2026-10-01&to=2026-10-31
الافتتاح والأعلى والأدنى والإغلاق اليومي لكل عيار. حتى 366 يوماً في الطلب الواحد، وبدون تواريخ تُرجع آخر 30 يوماً. متاحة في الباقات التي تشمل الأرشيف.
{
"ok": true,
"data": {
"currency": "SAR", "unit": "gram",
"from": "2026-10-01", "to": "2026-10-02", "count": 2,
"days": [
{ "date": "2026-10-01",
"24k": { "open": 495.1, "high": 499.0, "low": 493.8, "close": 497.2 },
"22k": { … }, "21k": { … }, "18k": { … }, "14k": { … } },
…
]
},
"meta": { … }
}
الحدود والأخطاء
كل رد يحمل الترويستين X-Quota-Limit وX-Quota-Remaining. والأخطاء ترجع بالشكل:
{
"ok": false,
"error": {
"code": "monthly_quota_exceeded",
"message": "Monthly quota reached (30000 requests). It resets on the 1st of next month (Riyadh time).",
"message_ar": "استهلكت حد الشهر (30000 طلب). يتجدد أول الشهر القادم بتوقيت الرياض."
}
}
| الرمز | الحالة | المعنى |
|---|---|---|
| 401 | missing_key / invalid_key | المفتاح غير مرسل أو غير صحيح. |
| 403 | key_suspended / key_expired / plan_forbidden | المفتاح موقوف أو منتهٍ، أو الباقة لا تشمل الطلب. |
| 429 | rate_limited / monthly_quota_exceeded | تجاوز حد الدقيقة (انتظر Retry-After ثانية) أو حد الشهر. |
| 400 | invalid_date / range_too_large | تواريخ غير صحيحة في طلب الأرشيف. |
| 503 | no_data | لا يتوفر سعر مؤقتاً؛ أعد المحاولة بعد قليل. |
أمثلة
JavaScript (Node.js 18 أو أحدث):
const res = await fetch("https://tibr.live/api/v1/latest", {
headers: { Authorization: "Bearer " + process.env.TIBR_API_KEY }
});
const { ok, data, error } = await res.json();
if (ok) console.log("عيار 21:", data.prices["21k"], "ريال");
else console.error(error.code, error.message_ar);
PHP:
$ch = curl_init("https://tibr.live/api/v1/latest");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("TIBR_API_KEY")],
CURLOPT_TIMEOUT => 10,
]);
$r = json_decode(curl_exec($ch), true);
echo $r["ok"] ? $r["data"]["prices"]["21k"] : $r["error"]["message_ar"];
الباقات
تجربة
مجاناً
- 500 طلب في الشهر
- حتى 1 طلب في الدقيقة
- آخر الأسعار فقط
- لمدة 7 يوماً لتجربة الواجهة
أساسية
120 ر.س / شهرياً
أو 1,200 ر.س سنوياً (شهران مجاناً)
- 15,000 طلب في الشهر
- حتى 10 طلب في الدقيقة
- آخر الأسعار فقط
الأنسب لأغلب المتاجر
احترافية
299 ر.س / شهرياً
أو 2,990 ر.س سنوياً (شهران مجاناً)
- 100,000 طلب في الشهر
- حتى 30 طلب في الدقيقة
- تشمل الأسعار التاريخية
أعمال
699 ر.س / شهرياً
أو 6,990 ر.س سنوياً (شهران مجاناً)
- 500,000 طلب في الشهر
- حتى 300 طلب في الدقيقة
- تشمل الأسعار التاريخية
الأسعار بالريال السعودي. ابدأ بمفتاح تجربة مجاني، ثم اختر الباقة المناسبة. ولباقة بحدود مختلفة تواصل معنا.
احصل على مفتاح تجربة مجانيأو عبر واتساب
ملاحظات
- الأسعار مرجعية محسوبة من سعر الأونصة العالمي وسعر الصرف وفق منهجية تِبر، ولا تشمل المصنعية ولا الضريبة، وقد تختلف عن أسعار المحلات.
- يخضع استخدام الواجهة لـشروط الاستخدام، ولا يجوز إعادة بيع البيانات أو مشاركة المفتاح مع جهة أخرى.
- نحافظ على ثبات شكل الردود في الإصدار v1؛ أي حقول جديدة تُضاف دون حذف الحقول الحالية.