خلاصه در یک نگاه: API قیمت ارز یک آدرس است که سایت یا ربات شما هر چند دقیقه از آن نرخ دلار، یورو، درهم و ارزهای دیگر را بهصورت JSON میگیرد. اول تصمیم بگیرید کدام نرخ را میخواهید: نرخ بازار آزاد (۹ آبان ۱۴۰۵ حدود ۲۷۱ تا ۲۷۲ هزار تومان برای دلار) یا نرخ حواله مرکز مبادله (همان روز حدود ۱۸۷ هزار تومان). این دو عدد نزدیک ۸۵ هزار تومان با هم فاصله دارند. بعد یک سرویس اصلی و یک سرویس پشتیبان انتخاب کنید، نرخ را روی سرور خودتان کش کنید و کنار هر عدد زمان بهروزرسانیاش را نشان دهید.
- کلید API را هیچوقت در کد مرورگر نگذارید؛ نرخ را سرور شما بگیرد و به صفحه بدهد.
- همیشه فیلد زمان نرخ را بخوانید. عددی که چند ساعت پیش ثبت شده، نرخ امروز نیست.
- واحد را چک کنید؛ بیشتر APIها تومان میدهند ولی بعضی ریال.
- اگر قیمت محصولتان با دلار عوض میشود، قیمت را لحظه ثبت سفارش قفل کنید.
بهروزرسانی: ۹ آبان ۱۴۰۵ — نرخها، محدودیتها و تعرفه سرویسها از مستندات رسمی خودشان و پاسخ زنده API بررسی شدهاند.
صاحب یک فروشگاه قطعات وارداتی را در نظر بگیرید که هر صبح قیمت دویست کالا را با دست عوض میکند. یک روز دیر میرسد، دلار بالا رفته و تا ظهر چند سفارش با قیمت دیروز ثبت میشود. صرافیها، تورهای خارجی، فروشندگان لوازم جانبی موبایل و هر کسبوکاری که قیمتش به ارز بسته است، همین دردسر را دارند. API قیمت ارز همین کار تکراری را خودکار میکند.
در این راهنما ساده توضیح میدهیم API قیمت ارز چه دادهای میدهد، چه نرخی را باید بگیرید، چه سرویسهایی در ایران هست، اتصال درست چه شکلی دارد و کجا معمولاً خراب میشود. اگر با خود API و یکپارچهسازی آشنا نیستید، اول راهنمای یکپارچهسازی API را ببینید.

API قیمت ارز دقیقاً چه چیزی به سایت شما میدهد؟
یک پاسخ JSON که برای هر ارز دستکم نماد، قیمت، واحد و زمان بهروزرسانی را دارد. سرویسهای کاملتر قیمت خرید و فروش، بیشترین و کمترین قیمت ۲۴ ساعت، درصد تغییر و منبع نرخ را هم میدهند. سایت شما این پاسخ را میخواند و هر جا لازم باشد نشان میدهد یا در حساب قیمت محصول به کار میبرد.
یک نمونه واقعی: پاسخ API عمومی ارزبان (fm5.ir) برای دلار در ۹ آبان ۱۴۰۵ این فیلدها را داشت: نماد USD، قیمت ۲۷۱٬۰۶۰، واحد TMN یعنی تومان، بیشینه و کمینه ۲۴ ساعته، منبع (source) و زمان ثبت نرخ (updated_at). همین دو فیلد آخر بیشتر از بقیه به کار میآیند. اولی میگوید عدد از کجا آمده و دومی میگوید چقدر تازه است.
کاربردهای رایج در سایتهای ایرانی:
- تابلوی نرخ در سایت صرافی یا سایت خبری.
- محاسبه خودکار قیمت کالاهای وارداتی از روی قیمت دلاری یا درهمی.
- مبدل ارز در صفحه تور خارجی یا ثبتنام آزمونهای بینالمللی.
- ربات تلگرام، بله یا ایتا که نرخ روز را برای مشتریها میفرستد.
- هشدار داخلی برای مدیر وقتی دلار از یک عدد مشخص بالاتر رفت.
کدام نرخ دلار را باید بگیرید؟
در ایران «نرخ دلار» یک عدد نیست. دستکم سه نرخ کنار هم هست و API هر سرویس معمولاً فقط یکیاش را میدهد. قبل از انتخاب سرویس، معلوم کنید کسبوکار شما با کدام نرخ خرید و فروش میکند.
| نرخ | از کجا میآید | دلار در ۹ آبان ۱۴۰۵ | به درد چه کسی میخورد |
|---|---|---|---|
| بازار آزاد | معاملههای بازار و صرافیها؛ بعضی سرویسها از بازار تتر حساب میکنند | حدود ۲۷۱ تا ۲۷۲ هزار تومان | فروشگاه کالای وارداتی، صرافی، سایت خبری |
| حواله مرکز مبادله | تالار حواله مرکز مبادله ارز و طلای ایران | حدود ۱۸۷ هزار تومان (فروش) | واردکنندهای که ارزش را از سامانه رسمی میگیرد |
| نرخ رسمی بانک مرکزی | صفحه نرخ ارز بانک مرکزی؛ بر پایه معاملههای روز کاری قبل در تالار حواله | هر روز کاری در سایت بانک مرکزی (cbi.ir) اعلام میشود | گزارش مالی، قرارداد و محاسبههای رسمی |
منبع اعداد: پاسخ API ارزبان و تابلوی TGJU، ۹ آبان ۱۴۰۵. نرخها هر روز و گاهی هر ساعت عوض میشوند. این جدول نشان میدهد چرا یک اشتباه کوچک در انتخاب نرخ گران تمام میشود.
اگر فروشگاهی کالایش را با دلار آزاد خریده ولی سایتش نرخ حواله را بگیرد، هر دلار را حدود ۸۵ هزار تومان ارزانتر حساب کرده است. برعکسش هم مشتری را فراری میدهد. پس اسم نرخ را در تنظیمات سایت روشن بنویسید، مثلاً «دلار آزاد – فروش»، نه فقط «دلار».
چه سرویسهایی API قیمت ارز در ایران میدهند؟
چند سرویس ایرانی API نرخ ارز دارند. بعضی رایگان و بدون ثبتناماند، بعضی کلید میخواهند و نسخه پولی دارند. فرق اصلیشان در تأخیر نرخ، سقف درخواست، شرایط استفاده و منبع داده است. چهار نمونه را از روی مستندات خودشان بررسی کردیم:
| سرویس | ثبتنام و کلید | تازگی و سقف درخواست | نکته مهم |
|---|---|---|---|
| ارزبان (fm5.ir) | عمومی و بدون ثبتنام | بهروزرسانی دقیقهای؛ ۱۲۰ درخواست در دقیقه برای هر IP | تاریخچه و مبدل دارد؛ خواسته لینک منبع در سایت بیاید؛ نرخها را «برای اطلاع» میداند |
| نِت اَرز (netarz.ir) | کلید رایگان با عضویت؛ قفل دامنه و IP | طرح رایگان با تأخیر (هنگام بررسی ما ۱۵ دقیقه)؛ ۶۰ درخواست در دقیقه و ۳٬۰۰۰ در روز | طرح پرو ۵ دلار در ماه برای هر اپ: نرخ بدون تأخیر، تاریخچه، وبهوک و استریم؛ دلار را از بازار تتر حساب میکند |
| EZRate | کلید در هدر X-API-Key؛ طرح رایگان با ثبتنام | بهروزرسانی هر ۶۰ ثانیه | قبل از استفاده تجاری شرایط طرح را بخوانید |
| Servix | کلید در هدر X-API-Key | فیلد جداگانه برای زمان معامله (businessTime) | برای سنجش تازگی نرخ مفید است |
منبع: مستندات رسمی هر سرویس، بررسیشده در ۹ آبان ۱۴۰۵. این فهرست معرفی است، نه رتبهبندی. قبل از اتصال، صفحه قوانین هر سرویس را بخوانید. مثلاً قوانین نت ارز بازفروش داده را ممنوع کرده است. یعنی اگر میخواهید خودتان API نرخ بفروشید، این سرویس به کارتان نمیآید.
یک نکته کوچک ولی مهم: سرویسها گاهی داده را از جای دیگری میگیرند. در پاسخ ارزبان، منبع دلار «tgju» ثبت شده بود. پس عملاً دو سرویس از یک منبع تغذیه میکنند و انتخابشان بهعنوان اصلی و پشتیبان، شما را از خطای منبع مشترک نجات نمیدهد. پشتیبان را از منبع دیگری انتخاب کنید.
اتصال درست API قیمت ارز به سایت چه شکلی دارد؟
نسخه درست ساده است: سرور شما هر یک تا پنج دقیقه نرخ را از سرویس اصلی میگیرد، چک میکند عدد منطقی و تازه باشد، در کش ذخیره میکند و صفحهها همیشه از همین کش میخوانند. اگر سرویس اصلی جواب نداد، سرور سراغ سرویس پشتیبان میرود. اگر آن هم نشد، آخرین نرخ سالم را با زمانش نشان میدهد.

چرا همین چند قدم اینقدر مهم است؟
- کلید امن میماند: اگر کلید در جاوااسکریپت صفحه باشد، هر بازدیدکنندهای میتواند ببیند و با آن سهمیه شما را تمام کند.
- سقف درخواست پر نمیشود: با سقف ۳٬۰۰۰ درخواست در روز، اگر هر بازدید یک درخواست بفرستد، چند صد بازدیدکننده کافی است تا ظهر سهمیه تمام شود. با کش، سرور فقط هر چند دقیقه یک درخواست میفرستد.
- سایت کند نمیشود: صفحه منتظر جواب سرویس بیرونی نمیماند. اگر سایتتان از قبل کند است، علتهای رایجش را در سایت کند است؟ نوشتهایم.
- عدد خراب منتشر نمیشود: قبل از ذخیره، نرخ جدید را با قبلی مقایسه کنید. اگر مثلاً بیش از ۱۰ درصد در یک بار پرید، ذخیرهاش نکنید و به مدیر خبر بدهید. شاید فقط واحد عوض شده باشد.
دو باگ رایج را هم از اول ببندید. اول تومان و ریال: نت ارز و ارزبان تومان میدهند، ولی عدد حواله مرکز مبادله در بعضی منابع ریالی است (۱٬۸۷۱٬۶۶۴ ریال یعنی حدود ۱۸۷ هزار تومان). یک صفر جابهجا، قیمت را ده برابر میکند. دوم ساعت: بعضی APIها زمان را با منطقه زمانی میدهند و بعضی بدون آن. زمان را با ساعت ایران مقایسه کنید و اگر نرخ مثلاً بیش از یک ساعت کهنه بود، کنارش بنویسید «آخرین بهروزرسانی».
اگر میخواهید قبل از هر کدنویسی، نرخ مناسب، سرویس اصلی و پشتیبان و قاعده قیمتگذاری سایتتان را یک بار با هم مرور کنیم، از صفحه تماس با پونوکد وقت مشاوره بگیرید.
قیمت محصول را چطور از روی نرخ ارز حساب کنیم؟
یک فرمول ثابت در سایت تعریف کنید: قیمت ارزی کالا × نرخ ارز × ضریب سود، بعد گرد کردن. فرمول را یک جا نگه دارید تا با تغییر نرخ، همه محصولات با هم بهروز شوند. یک مثال فرضی با دلار آزاد ۲۷۲ هزار تومانی:
| مرحله (مثال فرضی) | محاسبه | نتیجه |
|---|---|---|
| قیمت ارزی کالا | از تأمینکننده | ۱۲۰ دلار |
| تبدیل به تومان | ۱۲۰ × ۲۷۲٬۰۰۰ | ۳۲٬۶۴۰٬۰۰۰ تومان |
| هزینه حمل و سود ۱۸ درصد | ۳۲٬۶۴۰٬۰۰۰ × ۱٫۱۸ | ۳۸٬۵۱۵٬۲۰۰ تومان |
| گرد کردن به بالا تا هزار تومان | قاعده فروشگاه | ۳۸٬۵۱۶٬۰۰۰ تومان |
سه قاعده این فرمول را امن میکند:
- قفل قیمت در سبد: قیمت را لحظه ثبت سفارش ثابت کنید و برای پرداخت چند دقیقه مهلت بدهید. اگر مهلت گذشت، با نرخ جدید حساب شود. همین منطق را در API قیمت طلا برای سایت با جزئیات توضیح دادهایم.
- کف و سقف تغییر: اگر نرخ در یک روز بیش از حد مشخصی عوض شد، قیمتها خودکار عوض نشوند تا مدیر تأیید کند.
- شفافیت با مشتری: مرکز توسعه تجارت الکترونیکی، با استناد به ماده ۳۳ قانون تجارت الکترونیکی، به فروشگاههای اینترنتی تذکر داده که قیمتها باید بهروز باشد. اگر قیمت نهایی به خاطر نوسان ارز قطعی نیست، باید روشن بنویسید که خریدار قیمت نهایی را استعلام کند. قیمت خودکار و بهروز، دقیقاً همین مشکل را حل میکند.
چه چیزهایی اتصال API ارز را خراب میکند؟
بیشتر خرابیها از فنی بودن کار نیست؛ از اتکا به یک منبع و نخواندن شرایط استفاده است. دی ۱۴۰۳، سایت بنبست که خیلی از سایتها و رباتها نرخ را از آن برمیداشتند، پس از اظهارات رئیسکل وقت بانک مرکزی درباره سایتهای اعلام نرخ، از دسترس خارج شد. هر سایتی که فقط به آن وصل بود، یکشبه نرخ نداشت.

- یک منبع: همیشه یک پشتیبان از منبع دیگر داشته باشید و هر چند وقت یک بار سالم بودنش را تست کنید.
- بیتوجهی به قوانین: لینک منبع را اگر خواسته شده بگذارید و اگر بازفروش ممنوع است، داده را به دیگران نفروشید.
- کلید در کد عمومی: کلید را در فایل تنظیمات سرور نگه دارید، نه در مخزن کد یا صفحه.
- نمایش عدد بیتاریخ: نرخ بدون ساعت بهروزرسانی، اعتماد مشتری را کم میکند؛ بهخصوص وقتی بازار تعطیل است.
- رها کردن بعد از راهاندازی: سرویسها نسخه API را عوض میکنند. یک هشدار ساده بگذارید که اگر نرخ یک ساعت بهروز نشد، به شما خبر بدهد.
هزینه اتصال API قیمت ارز چقدر است؟
هزینه دو بخش دارد: اشتراک داده و پیادهسازی. برای خیلی از سایتها اشتراک داده صفر است، چون طرح رایگان یا API عمومی با کش کافی است. اگر نرخ بدون تأخیر، تاریخچه بلند یا وبهوک لازم دارید، طرح پولی لازم میشود. مثلاً طرح پرو نت ارز ۵ دلار در ماه برای هر اپ است که با نرخ این روزها و مالیات، حدود ۱٫۵ میلیون تومان در ماه میشود.
هزینه پیادهسازی به این بستگی دارد که فقط تابلوی نرخ میخواهید یا قیمتگذاری خودکار همه محصولات، قفل قیمت و پنل مدیریت. بازه قیمت کارهای API را در هزینه طراحی API در ۱۴۰۵ و جای این هزینه در بودجه کل فروشگاه را در هزینه طراحی فروشگاه اینترنتی آوردهایم. برای صرافیها هم که تابلوی نرخ قلب سایت است، طراحی سایت صرافی را ببینید.
چکلیست اتصال API قیمت ارز به سایت
قبل از انتخاب سرویس:
- معلوم کردهاید کدام نرخ را میخواهید: آزاد، حواله یا رسمی، و خرید یا فروش
- تأخیر طرح رایگان برای کارتان قابل قبول است
- سقف درخواست با کش شما جور است
- قوانین استفاده، الزام لینک منبع و ممنوعیت بازفروش را خواندهاید
- سرویس پشتیبان از منبع داده دیگری انتخاب شده است
هنگام پیادهسازی و بعد از آن:
- کلید فقط روی سرور است و در صفحه دیده نمیشود
- نرخ در کش ذخیره میشود و صفحه از کش میخواند
- واحد تومان یا ریال در کد مشخص و تست شده است
- پرش غیرعادی نرخ ذخیره نمیشود و به مدیر هشدار میدهد
- کنار هر نرخ زمان بهروزرسانی نمایش داده میشود
- قیمت در سبد خرید برای مدت کوتاهی قفل میشود
- اگر نرخ یک ساعت بهروز نشد، هشدار میرسد
سؤالهای رایج
API قیمت ارز رایگان برای سایت فروشگاهی کافی است؟
اغلب بله. اگر هر چند دقیقه یک بار نرخ را روی سرور میگیرید و چند دقیقه تأخیر برایتان مهم نیست، طرح رایگان کافی است. برای صرافی یا کسبوکاری که روی نوسان دقیقهای معامله میکند، طرح بدون تأخیر لازم است.
هر چند وقت یک بار باید نرخ را از API بگیریم؟
برای فروشگاه معمولاً هر یک تا پنج دقیقه کافی است. سریعتر از سرعت بهروزرسانی خود سرویس هم فایدهای ندارد و فقط سهمیه را مصرف میکند.
میتوانم نرخ را مستقیم با جاوااسکریپت در صفحه بگیرم؟
برای API عمومی بدون کلید شدنی است، ولی توصیه نمیکنیم. سقف درخواست هر IP زود پر میشود، صفحه به سرویس بیرونی وابسته میشود و نمیتوانید عدد خراب را قبل از نمایش بگیرید. گرفتن نرخ روی سرور امنتر است.
چرا نرخ دلار سایت من با تابلوی صرافی محله فرق دارد؟
چون هر منبع نرخ را از بازار متفاوتی حساب میکند و زمان بهروزرسانیاش هم فرق دارد. بعضی از بازار تتر حساب میکنند و بعضی از معاملههای صرافیها. اختلاف چند صد تا چند هزار تومانی طبیعی است. مهم این است که منبع و زمان را روشن نشان دهید.
نمایش نرخ ارز در سایت مجوز میخواهد؟
نمایش نرخ برای اطلاع، کار رایجی است. ولی خرید و فروش ارز، کار صرافی است و مجوز بانک مرکزی میخواهد. اگر سایتتان قرار است معامله ارز انجام دهد، قبل از طراحی با مشاور حقوقی صحبت کنید.
API قیمت ارز را میشود به ربات تلگرام یا بله هم وصل کرد؟
بله. همان کش سرور میتواند نرخ را به ربات هم بدهد تا هر دو یک عدد نشان دهند. نمونه کاربردهای ربات را در ربات بله برای کسبوکار ببینید.
مطالب مرتبط
- یکپارچهسازی API؛ اتصال سایت به حسابداری، پیامک، درگاه و ترب
- API قیمت طلا برای سایت؛ نرخ خودکار، فرمول اجرت و قفل قیمت
- طراحی سایت صرافی؛ تابلوی نرخ ارز، حواله و مقررات
- هزینه طراحی API در ۱۴۰۵؛ از اتصال ساده تا سازمانی
اتصال API قیمت ارز با پونوکد
ما در پونوکد (Ponocode) اول با شما مشخص میکنیم کدام نرخ به کارتان میآید و قیمت محصولات با چه فرمولی ساخته میشود. بعد سرویس اصلی و پشتیبان را وصل میکنیم، کش و هشدار را راه میاندازیم و قیمت سایت، سبد خرید و ربات را یکی میکنیم. خدمات ما در صفحه خدمات و جزئیات ساخت سایت در طراحی سایت آمده است. بستهها و قیمتها را در صفحه تعرفهها ببینید.
برای مشاوره: تلفن ۰۹۹۱۵۶۱۵۹۴۶، تلگرام https://t.me/resonea، یا از فرم تماس پیام بگذارید.



