API مجاني

أسعار الذهب في الأردن بصيغة JSON أو CSV. بدون مفتاح، مع CORS مفتوح، ومخزنة مؤقتًا 30 ثانية. يرجى الاكتفاء بطلب واحد في الدقيقة لكل شاشة.

curl https://gold.yazanmy.com/api/v1/prices

{
  "currency": "JOD", "unit": "gram", "mode": "auto",
  "effectiveDate": "2026-10-28",
  "prices": [
    { "karat": "21", "sell": 82.8, "buy": 79,
      "change": { "sell": 0.4, "buy": 0.4 },
      "trend": { "sell": "up", "buy": "up" },
      "dayChange": { "sell": 0.1, "buy": 0.1 } }, …
  ]
}

ضع الأسعار في موقعك

<iframe src="https://gold.yazanmy.com/embed?karats=24,21,18&lang=ar&theme=light"
        width="360" height="230" style="border:0;border-radius:12px"></iframe>

الخيارات: karats و lang=ar|en و theme=light|dark. يتحدث كل دقيقتين.

GET/api/v1/prices

الأسعار الحالية مع التغير منذ التحديث السابق ومنذ الأمس. أضف ‎?karat=21‎ لعيار واحد.

جرّب: /api/v1/prices?karat=21

GET/api/v1/history

الافتتاح والإغلاق والأعلى والأدنى يوميًا لكل عيار. ‎days=0‎ للكل و ‎format=csv‎ لجدول.

جرّب: /api/v1/history?karat=21&days=30

GET/api/v1/changes

كل تغيير مسجل في السعر، الأحدث أولًا، مع الفروقات. ‎source‎ قيمته backfill أو live أو manual.

جرّب: /api/v1/changes?limit=10

GET/api/v1/stats

الأدنى والأعلى والمتوسط والتغير خلال 7 و30 و90 و365 يومًا والكل.

جرّب: /api/v1/stats?karat=24

GET/api/v1/convert

قيمة وزن معين. ‎side=sell‎ (تشتري) أو ‎buy‎ (تبيع)، و ‎making‎ أجرة الصياغة للغرام.

جرّب: /api/v1/convert?grams=10&karat=21&making=3

GET/api/v1/world

السعر العالمي الفوري (دولار/أونصة) بالدينار للغرام، ونسبة فرق سعر الأردن عنه. ‎history=1‎ يضيف القيم اليومية.

جرّب: /api/v1/world

GET/api/v1/summary

افتتاح وإغلاق وأعلى وأدنى يوم معين والتغير عن إغلاق اليوم السابق. ‎date=YYYY-MM-DD‎.

جرّب: /api/v1/summary

GET/api/v1/card

بطاقة إغلاق اليوم كصورة PNG بحجم 1080×1080 للمشاركة.

جرّب: /api/v1/card

GET/api/v1/gold-price/latest-by-karat

بنفس شكل الـ API الأصلي: عنصر لكل عيار.

جرّب: /api/v1/gold-price/latest-by-karat

GET/api/v1/gold-price

بنفس شكل المصدر: سجلات مقسمة لصفحات (page و size و sort). مع karatId و priceType و from و to.

جرّب: /api/v1/gold-price?karatId=2&size=4

GET/api/v1/gold-price/{id}

سجل واحد.

GET/api/v1/karat

قائمة العيارات (الأرقام مطابقة للمصدر).

جرّب: /api/v1/karat