معرفی

API نرخ ارز نِت اَرز همان نرخ‌هایی را که در تابلوی نرخ می‌بینید به‌صورت JSON در اختیار سایت، اپ یا ربات شما می‌گذارد: نرخ لحظه‌ای دلار (تتر) از بازار ایران و ۳۴ ارز دیگر که از برابری جهانی هر ارز با دلار ساخته می‌شوند — با قیمت خرید، فروش، میانگین و تغییر ۲۴ ساعته، همه به تومان.

اولین درخواست

curl https://netarz.ir/api/fx/v1/rates/USD \
  -H "Authorization: Bearer fx-ntz-v1-..."

{
  "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"
  },
  "meta": {
    "quote_currency": "IRT",
    "usd_irt": 102400,
    "as_of": "2026-09-05T10:20:00+03:30",
    "delayed_minutes": 0,
    "is_delayed": false,
    "plan": "pro",
    "refresh_interval_minutes": 5,
    "source": "netarz.ir"
  }
}

چه چیزی می‌گیرید

اصول پایه

• آدرس پایه: https://netarz.ir/api/fx/v1 — همهٔ مسیرهای این مستندات نسبت به آن هستند.
• احراز هویت: هدر Authorization: Bearer fx-ntz-v1-… (یا X-API-Key). کلید در URL پذیرفته نمی‌شود.
• قفل دامنه: درخواست مرورگر باید از دامنهٔ ثبت‌شده بیاید؛ درخواست سرور از IP مجاز. جزئیات در قفل دامنه.
• واحد: همهٔ قیمت‌ها تومان (IRT) به‌ازای unit واحد از ارز. برای دینار عراق unit برابر ۱۰۰ است.
• تازگی: meta.as_of زمان نرخ است؛ در طرح رایگان meta.delayed_minutes می‌گوید چند دقیقه عقب است.
• پاسخ‌ها: همیشه JSON با UTF-8، فیلد data برای محتوا و meta برای زمینه؛ خطاها همیشه در error با code ثابت.
• زمان‌ها: ISO 8601 با منطقهٔ زمانی. ورودی‌های زمانی Unix timestamp را هم می‌پذیرند.

نرخ از کجا می‌آید؟

یک عدد زنده وجود دارد: نرخ بازار دلار (تتر) در ایران که هر چند دقیقه یک‌بار به‌روز می‌شود. هر ارز دیگر همان عدد تقسیم بر برابری آن ارز با دلار است — برای ارزهای میخکوب (درهم، ریال سعودی، …) برابری ثابت است و برای ارزهای شناور (یورو، پوند، لیر، …) روزانه از منابع جهانی تازه می‌شود. قیمت خرید و فروش با یک اسپرد کوچک حول میانگین ساخته می‌شود.

ادامه

1. شروع سریع — در پنج دقیقه از ثبت‌نام تا اولین پاسخ.
2. طرح‌ها — چه چیزی رایگان است و چه چیزی پرو.
3. مرجع تعاملی — همهٔ endpointها را همان‌جا تست کنید.