توسعهدهندگاندریافت کلید رایگانهمان دادهای که روی 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 در سایت، اپلیکیشن، ربات تلگرام یا اکسل خود بگیرید. نرخها از میانهٔ معاملات واقعی گروهها و صرافیها ساخته میشوند و هر ۶۰ ثانیه بهروز میشوند. پلن رایگان بدون کارت بانکی فعال میشود و برای بیشتر سایتها و پروژههای شخصی کافی است.
قیمت طلای ۱۸ و ۲۴ عیار، مثقال، سکهٔ امامی، بهار آزادی، نیم و ربع سکه و انس جهانی را با همان کلید بگیرید؛ همراه با حباب سکه و درصد تغییر ۲۴ ساعته. برای فروشگاه طلا و جواهر، ماشینحساب قیمت طلا یا پنل حسابداری مناسب است.
قیمت بیتکوین، اتریوم، تتر و دهها رمزارز دیگر هم به دلار و هم به تومان در دسترس است؛ تبدیل به تومان با نرخ واقعی تتر انجام میشود، نه نرخ تخمینی. واحد خروجی را میتوانید تومان، ریال، دلار، تتر یا یورو انتخاب کنید.
اگر برنامهنویس نیستید، از بخش «ویجت» در پنل کاربری، جدول یا نمودار زندهٔ قیمت ارز و طلا را با یک خط کد در سایت خود قرار دهید؛ رنگ، زبان و ارزها قابل تنظیم است. برای وردپرس هم افزونهٔ آماده با شورتکد وجود دارد.