جلب سعر الذهب لكل غرام باستخدام Python ‏(24K و22K و18K)

إذا كان تطبيقك يحتاج إلى سعر الذهب لكل غرام، فاطلب سلم العيارات مباشرة من نقطة النهاية العامة /v1/carat. يعيد طلب واحد قيم 24K و22K و21K و20K و18K و16K و14K و10K بالعملة التي تختارها، ولا يلزم مفتاح API للتجربة.

جلب سعر الذهب لكل غرام باستخدام Python

يستخدم المثال مكتبة Python القياسية فقط، ويقرأ الأسعار كقيم Decimal لتجنب أخطاء الفاصلة العائمة في الحسابات المالية.

import json
from decimal import Decimal
from urllib.parse import urlencode
from urllib.request import Request, urlopen

url = "https://api.goldprice.dev/v1/carat?" + urlencode({"currency": "AED"})
with urlopen(Request(url, headers={"Accept": "application/json"}), timeout=10) as response:
    payload = json.load(response)

prices = {
    "currency": payload["currency"],
    "timestamp": payload["timestamp"],
    "24k": Decimal(payload["price_gram_24k"]),
    "22k": Decimal(payload["price_gram_22k"]),
    "18k": Decimal(payload["price_gram_18k"]),
}

يمكن تغيير AED إلى USD أو EUR أو GBP أو INR أو IDR أو JPY. احفظ timestamp أيضاً لأنه يحدد وقت رصد السعر.

حساب قيمة قطعة ذهب

لقطعة عيار 18K تزن 12.5 غراماً، اضرب سعر غرام 18K في الوزن ثم قرّب النتيجة النهائية مرة واحدة.

from decimal import Decimal, ROUND_HALF_UP

weight = Decimal("12.5")
value = (weight * prices["18k"]).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)

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

كيفية تحويل السعر إلى غرام وعيار

تحوّل الواجهة سعر XAU إلى العملة المختارة، وتقسم سعر الأونصة الترويسية على 31.1034768، ثم تضربه في نسبة النقاء مثل 22 / 24 أو 18 / 24.

قائمة التحقق للإنتاج

• احتفظ بالقيم بصيغة Decimal.
• خزّن timestamp مع السعر.
• خزّن الاستجابات الناجحة مؤقتاً وفق الحداثة المطلوبة.
• لا تستبدل فشل التحديث بصفر أو بطابع زمني جديد.
• صف النتيجة بأنها إرشادية وليست سعر تسوية.
• احتفظ بمفتاح الحساب على الخادم فقط.

راجع عقد نقطة النهاية الكامل أو استخدم واجهة البيانات التاريخية لبيانات OHLC اليومية.