احصل على سعر الذهب بالريال السعودي أو بعملتك

نفّذ ذلك باستخدام واجهة API

استخدم رمز السلعة لاختيار المعدن أو النفط، ثم رمز العملة لاختيار عملة التسعير. يدعم الذهب طلب الروبية مباشرة. أما أسعار الفضة والبلاتين والبلاديوم والنحاس وWTI وBrent الفورية فهي بالدولار الأمريكي، ولذلك يتطلب حسابها بالروبية سعر صرف USD/IDR أيضًا.

الأسعار الفورية للسلع والعملات متاحة مباشرة لكل حساب. وينطبق هذا على طلب الذهب المباشر وعلى الأسعار المستخدمة في التحويل. عند عرض المبلغ بالروبية، احتفظ بوقت السعر معه، مع بيان ما إذا كان المبلغ لكل أونصة تروي أم لكل غرام.

1. احصل على مفتاح API الخاص بك احصل على مفتاح مجاني واحفظه في متغير البيئة NARWHAL_API_KEY. أرسله بالصيغة Authorization: Bearer YOUR_KEY مع الطلبات إلى https://api.narwhalapi.com؛ وتستخدم طلبات السلع والعملات الحساب والمفتاح نفسيهما.
2. اختيار عملة التسعير للحصول على الذهب بالروبية، اطلب GET /v1/commodities/spot/XAU/IDR؛ وللفضة، اطلب سعرها الفوري بالدولار الأمريكي وGET /v1/fx/rates/USD?currencies=IDR. تحدد العملة التي تلي رمز الذهب عملة السعر المباشر، بينما يوفر طلب العملات السعر اللازم لتحويل الفضة.
3. حساب الأسعار بالروبية استخدم نص Python البرمجي لقراءة الذهب مباشرة بالعملة IDR، وضرب سعر الفضة بالدولار في سعر USD/IDR. كما يقسم سعر الذهب على عدد الغرامات في الأونصة التروي ليعطي سعرًا مقرّبًا لكل غرام.
   Python، الذهب والفضة بالروبية الإندونيسية

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com/v1"
   GRAMS_PER_TROY_OUNCE = 31.1034768
   
   # Gold is quoted in every FX currency we serve, so ask for rupiah directly.
   gold = requests.get(f"{API}/commodities/spot/XAU/IDR", headers=H, timeout=10).json()
   print(
       "gold IDR per oz  ",
       gold["price"],
       "->",
       round(float(gold["price"]) / GRAMS_PER_TROY_OUNCE),
       "per gram",
   )
   
   # Silver is quoted in US dollars only: convert with the USD/IDR rate.
   silver = float(
       requests.get(f"{API}/commodities/spot/XAG/USD", headers=H, timeout=10).json()[
           "price"
       ]
   )
   idr = float(
       requests.get(
           f"{API}/fx/rates/USD", params={"currencies": "IDR"}, headers=H, timeout=10
       ).json()["rates"][0]["rate"]
   )
   print("silver IDR per oz", round(silver * idr), "=", silver, "x", idr)

4. احتفظ بالوحدة مع السعر اقرأ مخرجات الذهب على أنها روبية لكل أونصة تروي وروبية لكل غرام، ومخرجات الفضة على أنها روبية لكل أونصة. يغيّر تحويل العملة عملة سعر الفضة، بينما تغيّر القسمة المنفصلة للذهب وحدة الوزن.

يقرأ النص البرمجي price من استجابة كل سلعة، وrate من مصفوفة rates في استجابة العملات. ويُقرَّب مبلغ الذهب لكل غرام بعد القسمة، ويُقرَّب مبلغ الفضة بالروبية بعد الضرب. ويتضمن حساب الفضة المطبوع سعر الدولار وسعر الصرف المستخدمين في ذلك الضرب.

تستخدم أخطاء API النوع application/problem+json مع الحقول status وcode وdetail وrequest_id. وإذا أعاد الطلب خطأً، فاقرأ code وdetail قبل استخدام الاستجابة في أي حساب للأسعار.

الحصول على السعر في جدول بيانات أو دون كود

لمعرفة سعر الذهب دون كود، افتح صفحات أسعار الذهب في Narwhal التي تعرض الذهب بعملات كثيرة. استخدم هذا المسار عندما تريد قراءة سعر الذهب بعملتك دون كتابة طلبات السلعة والعملات بنفسك.

في جدول البيانات، استخدم =XAUUSD * USDIDR، مع تعبئة الخليتين من API. تحتوي XAUUSD على سعر الذهب بالدولار الأمريكي، وUSDIDR على سعر الصرف من الدولار إلى الروبية. وحاصل ضربهما هو سعر الذهب بالروبية لوحدة الوزن نفسها. وهذا هو مسار التحويل للذهب؛ كما يقبل API طلب الذهب مباشرة بالعملة IDR.

متى تستخدم كل خيار

لماذا يختلف سعر الذهب المباشر عن المحوَّل بالروبية؟

لأن الأسعار تحمل طوابع زمنية مختلفة. ففي مثال 24 أكتوبر 2026، يحمل سعر الذهب المباشر بالروبية طابع 23 أكتوبر 2026 الساعة 20:59 UTC، بينما يحمل سعر الصرف طابع 23 أكتوبر 2026 الساعة 00:00 UTC. ولذلك فإن ضرب سعر الذهب بالدولار في ذلك السعر يستخدم وقتًا مختلفًا عن السعر المباشر بالروبية.

في مثال 24 أكتوبر 2026، يعطي ضرب الذهب بسعر USD 3,996.00 في USD/IDR 18,107.8 مبلغ Rp 72,358,769، أي أعلى بنسبة 0.3% من السعر المباشر Rp 72,145,300. اختر طريقة واحدة والتزم بها. ولسعر في وقت محدد، استخدم أشرطة بالطابع الزمني نفسه للطرفين.

هل أضرب في سعر USD/IDR أم أقسم عليه؟

اضرب سعر السلعة بالدولار في سعر USD/IDR لتحصل على السعر بالروبية. في مثال 24 أكتوبر 2026، يعني USD/IDR 18,107.8 أن دولارًا أمريكيًا واحدًا يشتري 18,107.8 روبية. اقرأ السعر على أنه عدد الروبيات لكل دولار، ثم اضربه في عدد الدولارات في سعر السلعة.

افصل تحويل العملة عن تحويل الوزن. الضرب في USD/IDR يعطي سعرًا بالروبية بوحدة الوزن نفسها في سعر السلعة. ولتعبّر عن سعر الذهب لكل غرام، اقسم سعره لكل أونصة تروي على 31.1034768، وهو عدد الغرامات في الأونصة التروي.

ما العملات التي يمكنني طلب الذهب بها مباشرة؟

يدعم الذهب العملات الموجودة في قائمة تغطية العملات. استخدم رمز العملة المدرج بعد XAU في طلب السعر الفوري. ويعني 404 currency_not_supported أن السلعة غير مسعّرة بتلك العملة.

تنطبق قائمة العملات على أسعار الذهب المباشرة. أما الفضة والبلاتين والبلاديوم والنحاس وWTI وBrent الفورية فتظل بالدولار الأمريكي فقط. لهذه السلع، استخدم سعرًا بالدولار واضربه في سعر صرف الدولار مقابل العملة التي تريدها.

مثال تطبيقي: الذهب والفضة بالروبية

في 24 أكتوبر 2026، كان سعر الذهب المباشر Rp 72,145,300 لكل أونصة تروي. ابدأ بهذا المبلغ بالروبية واقسمه على 31.1034768 غرام لكل أونصة تروي. قرّب الناتج إلى أقرب روبية لتحصل على Rp 2,319,525 لكل غرام.

بالنسبة إلى الفضة في 24 أكتوبر 2026، ابدأ بسعرها الفوري USD 53.9171 للأونصة. اضربه في سعر USD/IDR البالغ 18,107.8، ثم قرّب إلى أقرب روبية. والنتيجة Rp 976,320 للأونصة.