نِت اَرز · مستندات API نرخ ارز
همهٔ مستندات
تابلوی نرخ مرجع تعاملی کلید رایگان

نرخ‌ها

GET /rates و GET /rates/{code} در API نرخ ارز: تابلوی کامل، نرخ خرید، فروش و میانگین، تغییر ۲۴ ساعته، واحد مظنه و متادیتای تازگی هر نرخ.

base_url: https://netarz.ir/api/fx/v1 دلار امروز: ۲۷۳,۶۰۰ تومان به‌روزرسانی: 1405/07/05

دو endpoint، یک شکل داده. /rates کل تابلو (یا زیرمجموعه‌ای با codes) و /rates/{code} یک ارز را می‌دهد. برای همه، meta می‌گوید نرخ چقدر تازه است و دلار پایه چند بوده.

تابلوی کامل

GET /api/fx/v1/rates رایگان + پرو
پارامترنوعتوضیح
codesstringاختیاری. کدهای سه‌حرفی با کاما (USD,EUR). بدون آن همهٔ ارزهای فعال برمی‌گردند.
cURL
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
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تأخیر طرح (۰ در پرو).
planfree یا pro.
refresh_interval_minutesهر چند دقیقه نرخ دلار از بازار تازه می‌شود.

فهرست ارزها

GET /api/fx/v1/currencies رایگان + پرو

کاتالوگ بدون قیمت: کد، نام، کشور، نماد، واحد، شناور/ثابت، کد پرچم (flag، مثل ae) و لینک صفحهٔ ارز در نِت اَرز. IRT و IRR هم به‌عنوان ارز مظنه فهرست می‌شوند (فقط برای مبدل).

cURL
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 کش کنید.