القائمة

البدء السريع

احصل على سعر XAU/USD المباشر في دقائق.

قبل أن تبدأ

تحتاج إلى curl أو أي عميل HTTP، ومفتاح API مجاني. سجّل وأكّد بريدك وانسخ المفتاح من حسابك. تشمل الخطة المجانية 100 طلب في الساعة.

احصل على مفتاح مجاني

طلبك الأول

أرسل مفتاحك في ترويسة X-API-Key. احتفظ به على خادمك، لا في كود يراه الزوار.

curl --fail-with-body --max-time 10 "https://goldapi.dev/api/v1/price/XAU/USD" \  -H "X-API-Key: $API_KEY"

قراءة الرد

price هو السعر لوحدة الرد: أونصة تروي، أو رطل للنحاس. وgram هو سعر الجرام بالعيار المذكور في الرد، وupdatedAt هو وقت إنشاء الرد.

الاستجابة 200

{
    "symbol": "XAU",
    "name": "Gold",
    "currency": "USD",
    "unit": "oz",
    "price": 4072.1,
    "gram": 130.921,
    "karat": 24,
    "updatedAt": "2026-11-07T02:39:51+02:00"
}

عند حدوث خطأ

الأخطاء بصيغة JSON فيها الحقل error. وأشهرها في البداية 401 api_key_required عند غياب الترويسة، و401 invalid_api_key عند خطأ المفتاح، و403 email_not_verified قبل تأكيد البريد. وبعد تجاوز الحد تحصل على 429 rate_limit_exceeded مع ترويسة Retry-After.

الخطوات التالية