واجهة أسعار المعادن المباشرة

واجهة JSON بسيطة عبر HTTPS. الأسعار فورية واسترشادية، تُحدَّث كل 60 ثانية.

البداية

  1. أنشئ حسابك في liveratesapi.amarsoft.cloud/account وابدأ التجربة المجانية أو اختر خطة.
  2. انسخ مفتاحك فور ظهوره (يظهر مرة واحدة). إذا فقدته أنشئ مفتاحاً جديداً من حسابك.
  3. أرسل أول طلب:
curl "https://rates.amarcp.ae/v1/latest?metals=gold¤cy=AED&unit=gram" \
  -H "Authorization: Bearer amr_xxxx_your_key"

عنوان الواجهة: https://rates.amarcp.ae

تريد التأكد أن مفتاحك يعمل؟ اختبره هنا.

المصادقة

كل طلب يحمل المفتاح في الترويسة: Authorization: Bearer amr_<prefix>_<secret>. لا تضع المفتاح في رابط الطلب ولا في كود يعمل في متصفح العميل؛ اطلب الأسعار من خادمك.

GET/v1/latest

آخر سعر لمعدن أو أكثر.

المعاملالقيمالافتراضي
metalsgold, silver, platinum, palladium (مفصولة بفاصلة)gold
currencyAED, SAR, USD, KWD, QAR, BHD, OMR, EUR, GBP, INRUSD
unitoz, gram, kg, tolaoz
{
  "as_of": "2026-11-21T09:30:00Z",
  "fetched_at": "2026-11-21T09:30:04Z",
  "age_seconds": 3,
  "stale": false,
  "stale_after_seconds": 600,
  "market_open": true,
  "currency": "AED",
  "unit": "gram",
  "fx": {"rate_per_usd": 3.6725, "as_of": "2026-11-21T09:30:00Z"},
  "rates": {"gold": {
    "price": 312.9588, "bid": null, "ask": null, "as_of": "2026-11-21T09:30:00Z",
    "day": {"open": 311.2, "high": 314.05, "low": 310.6, "prev_close": 311.0,
            "change": 1.9588, "change_pct": 0.63, "since": "2026-11-20T22:00:00Z"},
    "karats": {"24": 312.9588, "22": 286.879, "21": 273.8389, "18": 234.7191}
  }}
}

GET/v1/history

السعر عبر فترة زمنية (الخطة الاحترافية والمؤسسات).

المعاملالوصف
metal, currency, unitكما في /v1/latest (معدن واحد).
fromوقت ISO، مطلوب.
toوقت ISO، الافتراضي الآن.
intervalraw (≤ 7 days), hour (≤ 93 days), day (≤ 10 years)

كل نقطة هي آخر سعر في الفترة. الفترة المسموحة حسب خطتك (history_days).

curl "https://rates.amarcp.ae/v1/history?metal=gold¤cy=AED&unit=gram&from=2026-11-01T00:00:00Z&interval=day" \
  -H "Authorization: Bearer $AMR_KEY"

GET/v1/account

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

GET/v1/health

دون مفتاح. 200 عندما تكون الأسعار حديثة و503 عند التقادم. لأدوات مراقبة التشغيل.

الحصة والحدود

كل رد من /v1/latest و/v1/history يحمل:

X-Quota-Limitحصتك الشهرية
X-Quota-Remainingالمتبقي هذا الشهر
X-Quota-Resetوقت إعادة الضبط (أول الشهر UTC)

عند تجاوز حد الدقيقة تحصل على 429 rate_limited مع Retry-After. عند انتهاء الحصة الشهرية 429 quota_exceeded حتى أول الشهر، أو قم بالترقية من حسابك.

الأخطاء

شكل الخطأ: {"error": {"code": "...", "message": "..."}}

HTTPcodemeaning
401missing_key / invalid_keyno key, unknown or revoked
403subscription_expired / not_startedoutside your plan's start/end dates
403metal_not_in_plan / history_range_not_in_planyour plan does not include it
403history_not_allowedyour plan has no history
400bad_metal / bad_currency / bad_unit / bad_range / range_too_longbad parameters
429rate_limitedper-minute limit; see Retry-After
429quota_exceededmonthly quota used; Retry-After = seconds to the 1st
503no_data / no_fxno price available yet

الأسعار المتقادمة

كل رد يحمل as_of وstale. تكون stale صحيحة إذا كان آخر سعر أقدم من stale_after_seconds (10 دقائق أثناء فتح السوق و72 ساعة في عطلة نهاية الأسبوع) أو سعر الصرف أقدم من 36 ساعة. لا تعرض سعراً متقادماً على أنه حي.

الأسعار استرشادية للاستخدام المعلوماتي والتجاري، وليست عرضاً للتداول. · مصادر البيانات