نفس البيانات التي تراها على EZRate — وسيط مجموعات التداول، مع السجل التاريخي والرسم البياني — بطلب REST بسيط. مخرجات JSON بلغتين ومناسبة لتطبيقات الجوال.
/v1/ratesآخر سعر شراء وبيع؛ لكل الرموز أو بعضها، بأي وحدة تريدها (تومان، ريال، دولار، تيثر، يورو، غرام ذهب…).
symbolsstringالرموز مفصولة بفواصل: usd,eur,g18,emami,btc (فارغ = الكل)categorystringتصفية حسب الفئة: fiat، gold، coin، cryptomarketstringالسوق: tehran (افتراضي)، herat، sulaymaniyah، dubai، istanbul، havalequotestringوحدة السعر: IRT تومان (افتراضي)، IRR ريال، أو رمز أي أصل: usd، usdt، eur، g18، btc…langstringلغة الأسماء: fa أو enGET https://api.ezrate.me/v1/rates?symbols=usd,btc
X-API-Key: ezr_live_xxxx
{
"data": [
{ "symbol": "usd", "code": "USD", "name": "دلار آمریکا", "category": "fiat",
"market": "tehran", "quote": "IRT", "buy": 259200, "sell": 259400,
"usd": null, "change_pct": 1.14, "sources": 14, "low_sources": false,
"updated_at": "2026-10-01T10:15:00Z" },
{ "symbol": "btc", "code": "BTC", "name": "بیتکوین", "category": "crypto",
"market": "global", "quote": "IRT", "buy": 21820000000, "sell": 21859000000,
"usd": "84896.00000000", "change_pct": 1.43, "sources": 1, "low_sources": true,
"updated_at": "2026-10-01T10:15:00Z" }
],
"meta": { "as_of": "2026-10-01T10:15:00Z", "freshness_sec": 1800, "quote": "IRT" }
}كل الأسعار بأي وحدة تريدها: تومان، ريال، أو سعر أي أصل مقابل أصل آخر (دولار، تيثر، يورو، غرام ذهب…). السعر بالوحدة X = السعر بالتومان ÷ سعر X بالتومان (شراء مع شراء، بيع مع بيع). نفس الوحدات تعمل في /convert و /cross أيضاً. المصادقة: الترويسة X-API-Key أو Authorization: Bearer.
quote=irtتومان (افتراضي)259400quote=irrريال2594000quote=usdبدولار طهران الحريورو ← 1.1204quote=usdtبالتيثربيتكوين ← 84,896quote=g18بغرام ذهب عيار 18عملة إمامي ← 10.02 غرامquote=eurباليورودولار ← 0.893X-RateLimit-Limit-Day: 50 X-RateLimit-Remaining-Day: 12 X-RateLimit-Limit-Month: 1500 X-RateLimit-Remaining-Month: 858 X-RateLimit-Reset: 2026-10-01T00:00:00+03:30
401مفتاح غير صالح أو ملغى403النطاق أو عنوان IP غير مسموح404رمز غير معروف429تجاوز الحد اليومي/الشهريإن كنت تريد فقط عرض أسعار الدولار والذهب والعملات المشفرة في موقع ووردبريس، فلا حاجة إلى الـ API: ثبّت إضافة EZRate المجانية وأنشئ شريط أسعار أو جدولاً أو بطاقات أو رسماً بيانياً من لوحة التحكم.
التثبيت من لوحة التحكم: الإضافات › أضف جديد › ابحث عن «EZRate».يقدّم API أسعار العملات من EZRate أسعار الشراء والبيع اللحظية للدولار واليورو والدرهم والليرة وعشرات العملات مقابل التومان والريال الإيراني بصيغة JSON، لموقعك أو تطبيقك أو بوت تلغرام. الأسعار وسيط صفقات حقيقية في مجموعات التداول والصرافين، وتُحدَّث كل 60 ثانية، والخطة المجانية لا تحتاج بطاقة.
بالمفتاح نفسه تحصل على سعر غرام الذهب عيار 18 و24 والمثقال وعملة إمامي وبهار آزادي والأونصة العالمية، مع البيتكوين والإيثريوم والتثر بالدولار والتومان. ويمكنك اختيار وحدة الإخراج: تومان أو ريال أو دولار أو USDT.
إلى جانب الأسعار، يقدّم الـ API فحص مخاطر محافظ العملات الرقمية: GET /v1/wallet/check يعيد مؤشر المخاطر وحالة تجميد USDT والعقوبات ومالك العنوان والأطراف. التفاصيل في صفحة فحص المحفظة.