همان دادهای که روی 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 در سایت، اپلیکیشن، ربات تلگرام یا اکسل خود بگیرید. این API ارز نرخها را از میانهٔ معاملات واقعی گروهها و صرافیها میسازد، نه از کپی سایتهای دیگر، و هر ۶۰ ثانیه بهروز میشود. API رایگان قیمت ارز بدون کارت بانکی و با یک ثبتنام ساده فعال میشود و برای بیشتر سایتها و پروژههای شخصی کافی است.
پرجستوجوترین درخواستها API قیمت دلار و API قیمت تتر است. هر دو نرخ از بازار آزاد تهران و معاملات واقعی تتر به تومان میآیند و در هر پاسخ زمان آخرین بروزرسانی و تعداد منابع فعال هم آمده است. برای دیدن همین اعداد در سایت، صفحهٔ قیمت دلار و قیمت تتر را ببینید؛ هر عددی که آنجا میبینید با همان کلید از API هم برمیگردد.
با API قیمت طلا و سکه قیمت طلای ۱۸ و ۲۴ عیار، مثقال، سکهٔ امامی، بهار آزادی، نیم و ربع سکه و انس جهانی را با همان کلید بگیرید؛ همراه با حباب سکه، ارزش ذاتی و درصد تغییر ۲۴ ساعته. این API طلا برای فروشگاه طلا و جواهر، ماشینحساب قیمت طلا و نرمافزار حسابداری طلافروشی مناسب است. نمونهٔ زندهٔ این دادهها را در صفحهٔ قیمت طلای ۱۸ عیار و قیمت سکه امامی ببینید.
قیمت بیتکوین، اتریوم، تتر و دهها رمزارز دیگر هم به دلار و هم به تومان در API قیمت ارز دیجیتال در دسترس است؛ تبدیل به تومان با نرخ واقعی تتر انجام میشود، نه نرخ تخمینی. واحد خروجی را با پارامتر quote میتوانید تومان، ریال، دلار، تتر، یورو یا حتی گرم طلا انتخاب کنید.
این وب سرویس قیمت ارز همهٔ داراییها را با یک ساختار ثابت برمیگرداند، پس اضافه کردن ارز یا سکهٔ تازه به سایت شما فقط یک نماد بیشتر در درخواست است. مستندات کامل نشانیها، پارامترها و نمونهٔ پاسخها بالای همین صفحه و در نمونهکدها و مشخصات OpenAPI در گیتهاب آمده است.
اگر برنامهنویس نیستید، به API نیازی ندارید: در پنل کاربری ویجت قیمت ارز برای سایت بسازید و کد قیمت ارز برای سایت را (یک خط HTML) در صفحهٔ خود بگذارید؛ جدول، نوار متحرک یا نمودار رایگان قیمت ارز با زبان و واحد پول دلخواه. برای وردپرس هم افزونه قیمت ارز وردپرس با شورتکد آماده است. جزئیات را در صفحهٔ ویجت قیمت وبسایت ببینید.