دو endpoint، یک شکل داده. /rates کل تابلو (یا زیرمجموعهای با codes) و /rates/{code} یک ارز را میدهد. برای همه، meta میگوید نرخ چقدر تازه است و دلار پایه چند بوده.
تابلوی کامل
GET
/api/fx/v1/rates
رایگان + پرو
| پارامتر | نوع | توضیح |
|---|---|---|
codes | string | اختیاری. کدهای سهحرفی با کاما (USD,EUR). بدون آن همهٔ ارزهای فعال برمیگردند. |
curl "https://netarz.ir/api/fx/v1/rates?codes=USD,EUR,AED,TRY" \
-H "Authorization: Bearer $NETARZ_FX_KEY"
{
"data": [
{ "code": "USD", "name": "دلار آمریکا", "name_en": "US Dollar", "symbol": "$", "unit": 1, "per_usd": 1, "is_pegged": true,
"buy": 101900, "sell": 102900, "mid": 102400, "change_24h_percent": 0.39, "quote_currency": "IRT" },
{ "code": "EUR", "name": "یورو", "name_en": "Euro", "symbol": "€", "unit": 1, "per_usd": 0.86, "is_pegged": false,
"buy": 118500, "sell": 119700, "mid": 119100, "change_24h_percent": 0.51, "quote_currency": "IRT" },
{ "code": "AED", "name": "درهم امارات", "name_en": "UAE Dirham", "symbol": "د.إ", "unit": 1, "per_usd": 3.6725, "is_pegged": true,
"buy": 27750, "sell": 28030, "mid": 27890, "change_24h_percent": 0.39, "quote_currency": "IRT" },
{ "code": "TRY", "name": "لیر ترکیه", "name_en": "Turkish Lira", "symbol": "₺", "unit": 1, "per_usd": 48.27, "is_pegged": false,
"buy": 2111, "sell": 2133, "mid": 2122, "change_24h_percent": -0.12, "quote_currency": "IRT" }
],
"meta": {
"quote_currency": "IRT", "usd_irt": 102400, "as_of": "2026-09-05T10:20:00+03:30",
"delayed_minutes": 0, "is_delayed": false, "plan": "pro",
"spread_note": "buy/sell are indicative quotes around the market mid; NetArz does not trade these currencies.",
"refresh_interval_minutes": 5, "source": "netarz.ir"
}
}
یک ارز
GET
/api/fx/v1/rates/{code}
رایگان + پرو
curl https://netarz.ir/api/fx/v1/rates/IQD \
-H "Authorization: Bearer $NETARZ_FX_KEY"
{
"data": { "code": "IQD", "name": "دینار عراق", "unit": 100, "per_usd": 1310, "is_pegged": false,
"buy": 7780, "sell": 7860, "mid": 7820, "change_24h_percent": 0.2, "quote_currency": "IRT" },
"meta": { "usd_irt": 102400, "as_of": "2026-09-05T10:20:00+03:30", "delayed_minutes": 0, "plan": "pro" }
}
به unit دقت کنید
قیمت برای unit واحد است. دینار عراق با unit: 100 یعنی ۷٬۸۲۰ تومان برای ۱۰۰ دینار. اگر قیمت یک واحد را میخواهید، بر unit تقسیم کنید.
فیلدهای هر ردیف
| فیلد | معنا |
|---|---|
code | کد ISO 4217 (سه حرف بزرگ). |
name / name_en / symbol | نام فارسی، نام انگلیسی، نماد. |
unit | تعداد واحدی که قیمت برای آن است (۱ یا ۱۰۰). |
per_usd | چند واحد از این ارز برابر یک دلار است (برابری). |
is_pegged | برابری ثابت (میخکوب به دلار) یا شناور (روزانه بهروز میشود). |
mid | میانگین بازار: usd_irt ÷ per_usd × unit، گردشده روی گام مناسب (۱۰۰ / ۱۰ / ۱ تومان). |
buy / sell | خرید و فروش: میانگین با اسپرد کوچک باز شده حول آن. جهت از دید صرافی است (buy = صرافی میخرد). |
change_24h_percent | تغییر درصدی نسبت به بستهٔ دیروز، در ترم خود آن ارز (برای ارز شناور، حرکت برابری هم حساب میشود). null اگر دیروز دادهای نباشد. |
فیلدهای meta
| فیلد | معنا |
|---|---|
usd_irt | نرخ بازار دلار به تومان که این پاسخ از آن ساخته شده. |
as_of | زمان آن نرخ. در طرح رایگان از «الان» عقبتر است. |
delayed_minutes / is_delayed | تأخیر طرح (۰ در پرو). |
plan | free یا pro. |
refresh_interval_minutes | هر چند دقیقه نرخ دلار از بازار تازه میشود. |
فهرست ارزها
GET
/api/fx/v1/currencies
رایگان + پرو
کاتالوگ بدون قیمت: کد، نام، کشور، نماد، واحد، شناور/ثابت، کد پرچم (flag، مثل ae) و لینک صفحهٔ ارز در نِت اَرز. IRT و IRR هم بهعنوان ارز مظنه فهرست میشوند (فقط برای مبدل).
curl https://netarz.ir/api/fx/v1/currencies \
-H "Authorization: Bearer $NETARZ_FX_KEY"
ارزهای فعال الان
| کد | نام | واحد | نوع |
|---|---|---|---|
USD | دلار آمریکا | ۱ | ثابت |
AED | درهم امارات | ۱ | ثابت |
EUR | یورو | ۱ | شناور |
GBP | پوند انگلیس | ۱ | شناور |
SAR | ریال عربستان | ۱ | ثابت |
QAR | ریال قطر | ۱ | ثابت |
OMR | ریال عمان | ۱ | ثابت |
TRY | لیر ترکیه | ۱ | شناور |
BHD | دینار بحرین | ۱ | ثابت |
CNY | یوان چین | ۱ | شناور |
INR | روپیه هند | ۱ | شناور |
KWD | دینار کویت | ۱ | شناور |
JOD | دینار اردن | ۱ | ثابت |
RUB | روبل روسیه | ۱ | شناور |
AZN | منات آذربایجان | ۱ | شناور |
IQD | دینار عراق | ۱۰۰ | شناور |
HKD | دلار هنگکنگ | ۱ | شناور |
CAD | دلار کانادا | ۱ | شناور |
AUD | دلار استرالیا | ۱ | شناور |
CHF | فرانک سوئیس | ۱ | شناور |
JPY | ین ژاپن | ۱ | شناور |
SGD | دلار سنگاپور | ۱ | شناور |
MYR | رینگیت مالزی | ۱ | شناور |
THB | بات تایلند | ۱ | شناور |
SEK | کرون سوئد | ۱ | شناور |
NOK | کرون نروژ | ۱ | شناور |
DKK | کرون دانمارک | ۱ | شناور |
GEL | لاری گرجستان | ۱ | شناور |
AMD | درام ارمنستان | ۱۰۰ | شناور |
TMT | منات ترکمنستان | ۱ | شناور |
AFN | افغانی | ۱ | شناور |
PKR | روپیه پاکستان | ۱۰۰ | شناور |
UZS | سوم ازبکستان | ۱۰۰۰ | شناور · فقط پرو |
TJS | سامانی تاجیکستان | ۱ | شناور · فقط پرو |
نکتهها
- کش سمت خودتان: نرخ هر ۵ دقیقه عوض میشود؛ صدا زدن هر ثانیه فقط سهمیه میسوزاند. برای زندهترین حالت از استریم استفاده کنید.
- کد ناشناخته در
/rates/{code}→404 unknown_currency؛ درcodesفقط نادیده گرفته میشود. - ارزهای ویژهٔ پرو (UZS، TJS) در
/currenciesبا"pro_only": trueآمدهاند. طرح پرو نرخ زنده، تاریخچه و آرشیو روزانهٔ آنها را میگیرد؛ طرح رایگان روی/rates/{code}و/convertخطای402 pro_requiredمیگیرد و درcodesاین ارزها کنار گذاشته میشوند. - پاسخها
Cache-Control: no-storeدارند؛ خودتان با توجه بهas_ofکش کنید.