همان دادهای که روی 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به دلار آزاد تهرانیورو ← ۱٫۱۲۰۴quote=usdtبه تتربیتکوین ← ۸۴٬۸۹۶quote=g18به گرم طلای ۱۸سکه امامی ← ۱۰٫۰۲ گرمquote=eurبه یورودلار ← ۰٫۸۹۳X-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 أسعار الشراء والبيع اللحظية للدولار واليورو والدرهم والليرة وعشرات العملات مقابل التومان والريال الإيراني بصيغة JSON، لموقعك أو تطبيقك أو بوت تلغرام. الأسعار وسيط صفقات حقيقية في مجموعات التداول والصرافين، وتُحدَّث كل 60 ثانية، والخطة المجانية لا تحتاج بطاقة.
بالمفتاح نفسه تحصل على سعر غرام الذهب عيار 18 و24 والمثقال وعملة إمامي وبهار آزادي والأونصة العالمية، مع البيتكوين والإيثريوم والتثر بالدولار والتومان. ويمكنك اختيار وحدة الإخراج: تومان أو ريال أو دولار أو USDT.
إلى جانب الأسعار، يقدّم الـ API فحص مخاطر محافظ العملات الرقمية: GET /v1/wallet/check يعيد مؤشر المخاطر وحالة تجميد USDT والعقوبات ومالك العنوان والأطراف. التفاصيل في صفحة فحص المحفظة.