API نرخ ارز نِت اَرز · رایگان با عضویت
وبسرویس نرخ ارز (API)
داخل سایت و اپ خودتان
وبسرویس نرخ ارز نِت اَرز همان عددهای تابلوی نرخ ارز را در قالب JSON میدهد: ۳۲ ارز به تومان با قیمت خرید و فروش و مبدل. تاریخچه، آرشیو روزانه (دلار از ۱۳۶۰)، هشدار قیمت و استریم زنده در طرح پرو است. کلید فقط روی دامنهٔ ثبتشدهٔ شما و از IP سرورهایی که مجاز کردهاید کار میکند.
- ارز
- ۳۲
- بهروزرسانی
- هر ۵ دقیقه
- طرح رایگان
- ۳,۰۰۰/روز
| ارز | خرید | فروش | ۲۴ ساعت |
|---|---|---|---|
| دلار آمریکاUSD | ۲۷۲,۲۰۰ | ۲۷۵,۰۰۰ | +۰٪ |
| درهم اماراتAED | ۷۴,۱۰۰ | ۷۴,۹۰۰ | +۰٪ |
| یوروEUR | ۳۰۳,۹۰۰ | ۳۰۶,۹۰۰ | +۰٪ |
| پوند انگلیسGBP | ۳۶۳,۴۰۰ | ۳۶۷,۰۰۰ | +۰٪ |
| لیر ترکیهTRY | ۵,۴۵۰ | ۵,۵۱۰ | +۰٪ |
| دلار کاناداCAD | ۱۹۴,۶۰۰ | ۱۹۶,۶۰۰ | +۰٪ |
دلار ۲۷۳,۶۰۰ تومان · 04:31 · تابلوی کامل
یک درخواست GET، پاسخ JSON
کلید را در سربرگ درخواست (هدر Authorization) بفرستید. پاسخ دو بخش دارد: data با خودِ نرخها و meta با زمان نرخ، مقدار تأخیر و طرح شما. از مرورگر روی دامنهٔ خودتان صدا بزنید، یا از سروری که IP آن را مجاز کردهاید.
- همهٔ قیمتها به تومان است؛
unitمیگوید قیمت برای چند واحد ارز است (دینار عراق: ۱۰۰ واحد) - هدرهای
X-Quota-*در هر پاسخ میگویند چقدر از سهمیهٔ امروز مانده - خطاها همیشه یک شکل دارند:
error.code، پیام فارسی و لینک مستندات
// در مرورگر، روی دامنهٔ ثبتشدهٔ اپ
const res = await fetch("https://netarz.ir/api/fx/v1/rates?codes=USD,EUR,AED", {
headers: { Authorization: "Bearer fx-ntz-v1-..." },
});
const { data, meta } = await res.json();
for (const r of data) {
console.log(r.code, r.buy, r.sell, r.change_24h_percent + "%");
}
console.log("دلار:", meta.usd_irt, "تومان", meta.as_of);
import requests
# از سرور: IP سرور را در پنل به فهرست IPهای مجاز اضافه کنید
r = requests.get(
"https://netarz.ir/api/fx/v1/convert",
params={"from": "USD", "to": "IRT", "amount": 250},
headers={"Authorization": "Bearer fx-ntz-v1-..."},
timeout=10,
)
data = r.json()["data"]
print(f'{data["amount"]} دلار = {data["result"]:,} تومان')
<?php
// Laravel (Http facade) — یا هر کلاینت HTTP دیگری
use Illuminate\Support\Facades\Http;
$rate = Http::withToken(env('NETARZ_FX_KEY'))
->get('https://netarz.ir/api/fx/v1/rates/USD')
->json('data');
echo "دلار: خرید {$rate['buy']} / فروش {$rate['sell']} تومان";
curl "https://netarz.ir/api/fx/v1/rates/USD" \
-H "Authorization: Bearer $NETARZ_FX_KEY"
API قیمت دلار به تومان، با پاسخ واقعی
قیمت دلار را با یک درخواست به /rates/USD میگیرید: نرخ خرید (buy)، فروش (sell)، میانگین بازار (mid) و تغییر نسبت به دیروز. پاسخ پایین همان است که یک اپ طرح رایگان در این دقیقه میگیرد، با همین عددها. در طرح رایگان، زمان نرخ (as_of) ۱۵ دقیقه از الان عقبتر است و delayed_minutes همین را میگوید؛ در طرح پرو نرخ لحظهای و بدون تأخیر است.
قیمت دلار به تومان
curl "https://netarz.ir/api/fx/v1/rates/USD" \
-H "Authorization: Bearer $NETARZ_FX_KEY"
{
"data": {
"code": "USD",
"name": "دلار آمریکا",
"name_en": "US Dollar",
"symbol": "$",
"unit": 1,
"per_usd": 1,
"is_pegged": true,
"buy": 272200,
"sell": 275000,
"mid": 273600,
"change_24h_percent": 0,
"quote_currency": "IRT"
},
"meta": {
"quote_currency": "IRT",
"usd_irt": 273600,
"as_of": "2026-10-30T20:11:03+00:00",
"delayed_minutes": 15,
"is_delayed": true,
"plan": "free",
"spread_note": "buy/sell are indicative quotes around the market mid; NetArz does not trade these currencies.",
"refresh_interval_minutes": 5,
"source": "netarz.ir"
}
}
API قیمت دلار به ریال
curl "https://netarz.ir/api/fx/v1/convert?from=USD&to=IRR&amount=100" \
-H "Authorization: Bearer $NETARZ_FX_KEY"
{
"data": {
"from": "USD",
"to": "IRR",
"amount": 100,
"side": "mid",
"rate": 2736000,
"result": 273600000
},
"meta": {
"usd_irt": 273600,
"as_of": "2026-10-30T20:11:03+00:00",
"plan": "free"
}
}
ریال یا تومان؟
همهٔ قیمتهای /rates به تومان است ("quote_currency": "IRT")، چون بازار ارز ایران با تومان حرف میزند. هر تومان ده ریال است: برای ریال، عدد را در ۱۰ ضرب کنید یا مثل نمونهٔ بالا از مبدل با to=IRR بپرسید. بعضی ارزها برای چند واحد قیمت دارند؛ unit را ببینید.
امکانات وبسرویس نرخ ارز
یک وبسرویس قیمت ارز برای سایت خبری، فروشگاه، ربات تلگرام، نرمافزار حسابداری یا اپ موبایل. تاریخچه، کندل، هشدار و استریم فقط در طرح پرو است.
نرخ از کجا میآید
دلار هر چند دقیقه از بازار تتر ایران؛ بقیهٔ ارزها از برابریشان با دلار. همان عددهای تابلوی نرخ ارز نِت اَرز.
قفل دامنه
کلید فقط از دامنهٔ تأییدشدهٔ شما یا IP سرورتان پذیرفته میشود؛ اگر کسی آن را از کد صفحه بردارد، در سایت خودش کار نمیکند.
۳۲ ارز به تومان
دلار، یورو، پوند، درهم، لیر، یوان، روپیه، دینار… با خرید، فروش، میانگین و تغییر ۲۴ ساعته.
مبدل هر جفت ارز
USD→IRT، EUR→AED، IRR→TRY… با انتخاب نرخ خرید، فروش یا میانگین در یک درخواست.
تاریخچه، کندل، آمار
سری زمانی در بازهٔ دلخواه، کندل (OHLC)، بیشینه، کمینه، میانگین و نوسان، و نرخ هر روز گذشته، دلار از ۱۳۶۰.
هشدار قیمت با وبهوک
«وقتی دلار از فلان قیمت گذشت، خبرم کنید»: یک POST امضاشده با HMAC به سرور شما، و اگر نرسید، چند بار دوباره میفرستیم.
استریم زنده (SSE)
هر تغییر نرخ همان لحظه به برنامهٔ شما میرسد، بدون درخواستهای پشتسرهم (polling)؛ از مرورگر یا سرور.
ویجت یکخطی
با یک تگ script، تابلوی نرخ روی سایت شماست؛ با پوستهٔ روشن، تیره یا طلایی.
مستندات فارسی و OpenAPI
پاسخهای JSON با ساختار ثابت، مستندات فارسی و مرجع تعاملی که درخواست را همانجا امتحان میکنید.
امنیت کلید
کلیدی که فقط روی دامنهٔ شما کار میکند
کلیدی که در کد صفحه میگذارید، دیده میشود. برای همین هر کلید را به دامنهٔ شما قفل کردهایم: درخواستی که از سایت دیگری بیاید پذیرفته نمیشود، و تا مالکیت دامنه را تأیید نکنید، کلید جواب نمیدهد.
- قفل Origin/Refererدرخواست مرورگر فقط از دامنههای ثبتشده پذیرفته میشود و مجوز CORS هم فقط برای همانهاست.
- IP سروردرخواست سمت سرور فقط از IP، پیشوند یا بازهٔ CIDR که خودتان مجاز کردهاید.
- اثبات مالکیت دامنهمثل Search Console گوگل: رکورد TXT در DNS یا یک فایل در /.well-known.
- هش کلیدخودِ کلید را نگه نمیداریم، فقط هش آن (SHA-256). کلید یک بار نمایش داده میشود و هر وقت بخواهید عوضش میکنید.
- محدودیت درخواستپیش از شناسایی کلید بهازای هر IP، بعد از آن بهازای هر اپ؛ سهمیهٔ روزانه را هم در هدر هر پاسخ میبینید.
- وبهوک امضاشدهامضای HMAC-SHA256 با زمانمهر، تلاش دوباره با فاصلهٔ فزاینده، فقط https و بدون ارسال به نشانیهای داخلی شبکه.
سه قدم تا اولین درخواست
ثبتنام و ساخت اپ
ثبتنام کنید و در پنل «API نرخ ارز» یک اپ بسازید: یک نام و دامنهٔ سایتتان. کلید فقط یک بار نمایش داده میشود؛ همان لحظه کپیاش کنید.
تأیید مالکیت دامنه
ثابت کنید دامنه مال شماست: یک رکورد TXT در تنظیمات DNS بسازید، یا فایل آماده را از پنل بگیرید و بدون ویرایش در پوشهٔ /.well-known بگذارید. بعد «بررسی» را بزنید. localhost برای تست خودکار تأیید میشود.
اولین درخواست
کلید را در هدر Authorization بفرستید؛ از مرورگر روی همان دامنه، یا از سروری که IP آن را در پنل مجاز کردهاید.
API نرخ ارز رایگان یا پرو؟ با رایگان شروع کنید
طرح رایگان فقط عضویت میخواهد: نرخ ارزهای تابلو با ۱۵ دقیقه تأخیر، مبدل، فهرست ارزها و ویجت، تا ۶۰ درخواست در دقیقه و ۳,۰۰۰ درخواست در روز. کلیدش مثل پرو فقط روی دامنهٔ تأییدشدهٔ شما و IPهای مجازتان کار میکند. نرخ بیتأخیر، تاریخچه، کندل، هشدار، استریم و ارزهای ویژهٔ پرو در طرح پرو است.
اشتراک پرو برای هر اپ جداست: ماهی ۵ دلار که با نرخ روز به تومان میپردازید؛ الان ۱,۴۹۱,۱۲۰ تومان با ۹٪ مالیات.
رایگان
۰ تومان · با عضویت
- نرخ همهٔ ارزهابا ۱۵ دقیقه تأخیر
- مبدل و فهرست ارزها
- تاریخچهندارد
- درخواست در دقیقه / روز۶۰ / ۳,۰۰۰
- کندل OHLC و آمار
- نرخ در لحظهٔ مشخص
- هشدار قیمت (وبهوک)
- استریم زنده SSE
- ویجت نرخ ارزبا لینک نِت اَرز
پرو
۵ دلار / ماه / هر اپ
≈ ۱,۴۹۱,۱۲۰ تومان با مالیات · پرداخت از کیف پول یا درگاه
- نرخ همهٔ ارزهازنده، بدون تأخیر
- مبدل و فهرست ارزها
- تاریخچه و آرشیوکل آرشیو، دلار از ۱۳۶۰ + CSV
- درخواست در دقیقه / روز۶۰۰ / ۲۰۰,۰۰۰
- کندل OHLC و آمار
- نرخ در لحظهٔ مشخص
- هشدار قیمت (وبهوک)تا ۲۰ هشدار امضاشده
- استریم زنده SSE
- ویجت نرخ ارزبدون برندینگ
ویجت نرخ ارز با یک تگ
این تگ را در صفحه بگذارید؛ لازم نیست خودتان جاوااسکریپت بنویسید. ویجت فقط روی دامنهٔ ثبتشدهٔ شما نمایش داده میشود، هر چند دقیقه خودش تازه میشود و سه پوسته دارد: روشن، تیره و طلایی.
<script src="https://netarz.ir/fx/widget.js"
data-key="fx-ntz-v1-..."
data-codes="USD,EUR,AED,TRY"
data-theme="light" async></script>
مستندات ویجت
| ارز | خرید | فروش | تغییر |
|---|---|---|---|
| USD دلار آمریکا | ۲۷۲,۲۰۰ | ۲۷۵,۰۰۰ | ▲ ۰٪ |
| AED درهم امارات | ۷۴,۱۰۰ | ۷۴,۹۰۰ | ▲ ۰٪ |
| EUR یورو | ۳۰۳,۹۰۰ | ۳۰۶,۹۰۰ | ▲ ۰٪ |
| GBP پوند انگلیس | ۳۶۳,۴۰۰ | ۳۶۷,۰۰۰ | ▲ ۰٪ |
| TRY لیر ترکیه | ۵,۴۵۰ | ۵,۵۱۰ | ▲ ۰٪ |
طرح پرو
تاریخچهٔ قیمت دلار با API، از ۱۳۶۰ تا امروز
/archive/USD نرخ پایانی بازار آزاد هر روز را با تاریخ شمسی و میلادی میدهد؛ دلار از ۱۳۶۰، که تا ۱۳۷۹ میانگین سالانه یا ماهانه است. تاریخ را شمسی یا میلادی بفرستید و برای اکسل format=csv بگذارید. هر پاسخ تا ۲۰,۰۰۰ روز را برمیگرداند، پس کل آرشیو دلار در یک درخواست جا میشود.
-
/history/USDسری زمانی برای نمودار، با فاصلهٔ ۵ دقیقه تا ماهانه -
/ohlc/USDکندل باز، بالا، پایین و بسته؛/stats/USDبیشینه، کمینه و نوسان - طرح رایگان تاریخچه ندارد و روی این مسیرها خطای
402 pro_requiredمیگیرد.
# دلار در یک روز (تاریخ شمسی یا میلادی)
curl "https://netarz.ir/api/fx/v1/archive/USD?date=1397-07-03" \
-H "Authorization: Bearer $NETARZ_FX_KEY"
# همهٔ روزهای یک سال، برای اکسل
curl "https://netarz.ir/api/fx/v1/archive/USD?from=1402-01-01&to=1402-12-29&format=csv" \
-H "Authorization: Bearer $NETARZ_FX_KEY" -o usd-1402.csv
{
"data": {
"code": "USD", "quote_currency": "IRT", "unit": 1,
"requested": "2018-09-25", "exact": true,
"date": "2018-09-25", "jdate": "1397-07-03",
"open": 19010, "high": 19350, "low": 16830, "close": 18670,
"source": "market", "resolution": "daily"
}
}
افزونهٔ وردپرس، گوگل شیت و ربات تلگرام، آماده
برای این سه کار لازم نیست از صفر کد بنویسید. هر کدام کد باز است و با همان کلید اپ شما کار میکند.
افزونهٔ نرخ ارز وردپرس
افزونهٔ NetArz FX با کد کوتاه (شورتکد) نرخ را داخل نوشته میگذارد: [netarz_rate currency="usd"] برای دلار، [netarz_rates] برای جدول چند ارز و [netarz_convert] برای مبدل. سه بلوک ویرایشگر و یک ابزارک هم دارد. در ووکامرس کنار قیمت ارزی هر محصول «حدود … تومان» میآید؛ خودِ قیمت محصول عوض نمیشود.
گوگل شیت و اکسل
تابع آمادهٔ =NETARZ_RATE("USD") برای Google Sheets و کوئری Power Query برای اکسل در مخزن نمونهکدها هست. گوگل شیت از IPهای متغیر گوگل درخواست میفرستد، پس کلید را پشت یک رله (relay) کوچک روی سرور خودتان میگذارید؛ فایل رله هم در همان مخزن است.
ربات تلگرام قیمت دلار
نمونهٔ آمادهٔ ربات به پایتون به /usd، /eur و «/convert 100 usd» جواب میدهد. کل تابلو را دو دقیقه کش میکند، پس گروه شلوغ هم هر دو دقیقه یک درخواست خرج میکند. ربات روی سرور اجرا میشود و IP خروجی همان سرور باید در «IPهای مجاز» اپ باشد. کد نمینویسید؟ @netarzbot را به کانال یا گروهتان اضافه کنید تا هر شش ساعت نرخ دلار، یورو، پوند و درهم را بفرستد.
Endpointها در یک نگاه
| مسیر | چه میدهد | طرح |
|---|---|---|
| GET /rates | تابلوی کامل: خرید، فروش، میانگین، تغییر ۲۴ ساعته | رایگان |
| GET /rates/{code} | یک ارز | رایگان |
| GET /convert | تبدیل هر جفت ارز، تومان و ریال | رایگان |
| GET /currencies | فهرست ارزها با نام، پرچم، واحد | رایگان |
| GET /history/{code} | سری زمانی از ۵ دقیقه تا ماهانه (کل آرشیو، دلار از ۱۳۶۰) — JSON یا CSV | پرو |
| GET /archive/{code} | نرخ پایانی هر روز با تاریخ شمسی و میلادی، یا نرخ یک تاریخ — JSON یا CSV | پرو |
| GET /ohlc/{code} | کندلهای باز/بالا/پایین/بسته | پرو |
| GET /stats/{code} | بیشینه، کمینه، میانگین، تغییر، نوسان | پرو |
| GET /snapshot/{code} | نرخ در یک لحظهٔ مشخص | پرو |
| GET /stream | استریم زندهٔ SSE | پرو |
| POST /alerts | هشدار قیمت با وبهوک امضاشده | پرو |
| GET /me · /status | اپ، طرح و سهمیهٔ شما · وضعیت سرویس و زمان آخرین نرخ | رایگان |
نظر کاربران همین سرویس
این نظرها را فقط کسانی نوشتهاند که با حساب خودشان از این سرویس استفاده میکنند. همه را پیش از انتشار بررسی میکنیم و نقد را هم منتشر میکنیم.
پرسشهای متداول
وب سرویس نرخ ارز با API نرخ ارز فرق دارد؟
نه، دو اسم برای یک چیزند. «وبسرویس» همان نشانی اینترنتی است که برنامهٔ شما صدا میزند و بهجای صفحهٔ وب، داده (JSON) تحویل میگیرد. نِت اَرز یک وبسرویس نرخ ارز دارد با نشانی پایهٔ https://netarz.ir/api/fx/v1؛ هر جای مستندات «API» نوشته شده، منظور همین است.
نرخها از کجا میآید و هر چند وقت بهروز میشود؟
نرخ دلار را هر چند دقیقه از بازار تتر ایران میگیریم و نرخ بقیهٔ ارزها را از برابریشان با دلار حساب میکنیم؛ همان عددهایی که در صفحهٔ نرخ ارز نِت اَرز میبینید. طرح رایگان نرخ را با ۱۵ دقیقه تأخیر میدهد و طرح پرو بیتأخیر.
API قیمت دلار رایگان هم دارید؟
بله، طرح رایگان همین وبسرویس است. در نِت اَرز ثبتنام میکنید، یک اپ میسازید و کلید میگیرید، بدون هیچ پرداختی؛ قیمت دلار و بقیهٔ ارزها را با ۱۵ دقیقه تأخیر میگیرید. سهم طرح رایگان روزی ۳,۰۰۰ درخواست است، با مبدل، فهرست ارزها و ویجت. نرخ بیتأخیر، تاریخچه و آرشیو در طرح پرو است.
API قیمت طلا و سکه هم دارید؟
با همین کلید، API بازارها انس جهانی طلا و نقره را به دلار میدهد؛ مستنداتش در netarz.ir/docs/markets است. عدد تومانی طلای ۱۸ عیار، مثقال و سکه «ارزش محاسبهای» از انس جهانی و دلار است و پس از بازبینی کارشناس به API اضافه میشود. قیمت بازار طلا و سکهٔ تهران و حباب سکه در هیچکدام از وبسرویسهای ما نیست.
قیمتها به تومان است یا ریال؟
به تومان؛ هر ردیف quote_currency: "IRT" دارد. هر تومان ده ریال است، پس برای ریال عدد را در ۱۰ ضرب کنید یا از مبدل بپرسید: /convert با from=USD و to=IRR قیمت دلار به ریال را میدهد. مبدل در طرح رایگان هم هست.
تاریخچهٔ قیمت دلار را هم از API میشود گرفت؟
بله، در طرح پرو. /archive/USD نرخ پایانی بازار آزاد هر روز را با تاریخ شمسی و میلادی میدهد، دلار از ۱۳۶۰، به JSON یا CSV. /history/USD سری زمانی و /ohlc/USD کندلها را میدهد. طرح رایگان تاریخچه ندارد و روی این مسیرها خطای pro_required میگیرد.
بدون ثبتنام و کلید هم کار میکند؟
نه. هر درخواست کلید یک اپ را لازم دارد و کلید تا مالکیت دامنه تأیید نشود جواب نمیدهد. ساخت حساب و اپ چند دقیقه کار است و برای آزمایش روی رایانهٔ خودتان، دامنهٔ localhost خودکار تأیید میشود.
افزونهٔ نرخ ارز وردپرس یا ربات تلگرام قیمت دلار دارید؟
بله. افزونهٔ وردپرس NetArz FX با کد کوتاه (شورتکد) [netarz_rate] نرخ را داخل نوشته میگذارد و در ووکامرس کنار قیمت ارزی محصول «حدود … تومان» نشان میدهد. برای ربات تلگرام، نمونهکد آمادهٔ پایتون در گیتهاب هست. اگر فقط نرخ را در کانالتان میخواهید، ربات @netarzbot را به کانال اضافه کنید.
طرح پرو چقدر است و چطور پرداخت میشود؟
ماهی ۵ دلار برای هر اپ، که موقع خرید با نرخ روز به تومان حساب میشود؛ الان حدود ۱,۴۹۱,۱۲۰ تومان با مالیات. از کیف پول یا درگاه بانکی میپردازید و تمدید خودکار از کیف پول را هر وقت خواستید خاموش میکنید. مبلغ اشتراکِ پرداختشده برنمیگردد.
قفل دامنه یعنی چه؟
یعنی کلید فقط از دو جا پذیرفته میشود: صفحههای دامنهٔ ثبتشدهٔ شما (از روی سربرگ Origin یا Referer مرورگر) و IPهای سروری که در پنل مجاز کردهاید. مالکیت دامنه را هم یک بار با رکورد DNS یا یک فایل تأیید میکنید. پس اگر کلید در کد صفحهتان دیده شود، سایت دیگری نمیتواند با آن نرخ بگیرد؛ اگر نگران لو رفتنش هستید، از پنل کلید تازه بسازید.
در محصول تجاری هم میشود استفاده کرد؟
بله، در محصول خودتان با هر دو طرح. فقط فروش خودِ داده یا ارائهٔ آن بهعنوان وبسرویس به دیگران، بدون مجوز کتبی مجاز نیست (قوانین، مادهٔ ۲۵). ویجت طرح رایگان لینک نِت اَرز را نشان میدهد و در پرو میتوانید آن را بردارید. نرخها برای اطلاعرسانی است، نه پیشنهاد خرید و فروش ارز.
اگر پرو تمدید نشود چه میشود؟
اپ به طرح رایگان برمیگردد و کلید همچنان کار میکند؛ فقط نرخ بیتأخیر، تاریخچه، هشدار و استریم تا تمدید بعدی خاموش میشوند.
نرخ ارز در دستیار هوش مصنوعی شما
سرور MCP نِت اَرز، Claude، ChatGPT و Cursor را به نرخ بازار آزاد تهران وصل میکند: نرخ، تبدیل، تاریخچه و طلا. برای شروع کلید لازم نیست؛ نشانی https://netarz.ir/api/fx/mcp را در برنامه اضافه کنید.
وبسرویس نرخ ارز را به محصولتان اضافه کنید
طرح رایگان بدون پرداخت، مستندات فارسی و پشتیبانی با چت و تیکت.