واجهة أسعار المعادن المباشرة
واجهة JSON بسيطة عبر HTTPS. الأسعار فورية واسترشادية، تُحدَّث كل 60 ثانية.
البداية
- أنشئ حسابك في liveratesapi.amarsoft.cloud/account وابدأ التجربة المجانية أو اختر خطة.
- انسخ مفتاحك فور ظهوره (يظهر مرة واحدة). إذا فقدته أنشئ مفتاحاً جديداً من حسابك.
- أرسل أول طلب:
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
آخر سعر لمعدن أو أكثر.
| المعامل | القيم | الافتراضي |
|---|---|---|
metals | gold, silver, platinum, palladium (مفصولة بفاصلة) | gold |
currency | AED, SAR, USD, KWD, QAR, BHD, OMR, EUR, GBP, INR | USD |
unit | oz, gram, kg, tola | oz |
{
"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}
}}
}
day: جلسة التداول الحالية (تبدأ 22:00 UTC من الأحد إلى الخميس؛ في عطلة نهاية الأسبوع تبقى جلسة الجمعة). بنفس العملة والوحدة.karats(الذهب فقط): سعر عيار 24 × العيار ÷ 24 لعيارات 24 و22 و21 و18.- الأسعار لعيار 24 / المعدن الصافي.
fxتكون null للدولار.
GET/v1/history
السعر عبر فترة زمنية (الخطة الاحترافية والمؤسسات).
| المعامل | الوصف |
|---|---|
metal, currency, unit | كما في /v1/latest (معدن واحد). |
from | وقت ISO، مطلوب. |
to | وقت ISO، الافتراضي الآن. |
interval | raw (≤ 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": "..."}}
| HTTP | code | meaning |
|---|---|---|
| 401 | missing_key / invalid_key | no key, unknown or revoked |
| 403 | subscription_expired / not_started | outside your plan's start/end dates |
| 403 | metal_not_in_plan / history_range_not_in_plan | your plan does not include it |
| 403 | history_not_allowed | your plan has no history |
| 400 | bad_metal / bad_currency / bad_unit / bad_range / range_too_long | bad parameters |
| 429 | rate_limited | per-minute limit; see Retry-After |
| 429 | quota_exceeded | monthly quota used; Retry-After = seconds to the 1st |
| 503 | no_data / no_fx | no price available yet |
الأسعار المتقادمة
الأسعار استرشادية للاستخدام المعلوماتي والتجاري، وليست عرضاً للتداول. · مصادر البيانات
