یک endpoint برای هر تبدیلی: ارز به تومان، تومان به ارز، ارز به ارز — و ریال هم پذیرفته می‌شود. تبدیل از مسیر دلار انجام می‌شود (هر ارز ← تومان ← ارز دیگر) پس همیشه با تابلو سازگار است.

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

پارامتر	نوع	توضیح
`from`	string	الزامی. کد ارز، یا `IRT` (تومان) / `IRR` (ریال).
`to`	string	الزامی. مثل بالا.
`amount`	number	اختیاری، پیش‌فرض ۱. مقدار در واحد یک ارز مبدأ (نه `unit` تابلو).
`side`	mid / buy / sell	اختیاری، پیش‌فرض `mid`. `buy`: شما ارز مبدأ را می‌فروشید و مقصد را می‌خرید با نرخ‌های خرید/فروش صرافی؛ `sell` برعکس. برای تومان همیشه ۱.

نمونه‌ها

دلار → تومان

curl "https://netarz.ir/api/fx/v1/convert?from=USD&to=IRT&amount=250" \
  -H "Authorization: Bearer $NETARZ_FX_KEY"

پاسخ

{
  "data": { "from": "USD", "to": "IRT", "amount": 250, "side": "mid", "rate": 102400, "result": 25600000 },
  "meta": { "usd_irt": 102400, "as_of": "2026-09-05T10:20:00+03:30", "delayed_minutes": 0, "plan": "pro" }
}

یورو → درهم

# ۱۰۰ یورو چند درهم است؟ (با نرخ فروش)
curl "https://netarz.ir/api/fx/v1/convert?from=EUR&to=AED&amount=100&side=sell" \
  -H "Authorization: Bearer $NETARZ_FX_KEY"

پاسخ

{ "data": { "from": "EUR", "to": "AED", "amount": 100, "side": "sell", "rate": 4.3133, "result": 431.3312 }, "meta": { "…": "…" } }

تومان → دلار

# ۵۰ میلیون تومان چند دلار می‌شود؟
curl "https://netarz.ir/api/fx/v1/convert?from=IRT&to=USD&amount=50000000" \
  -H "Authorization: Bearer $NETARZ_FX_KEY"

گرد کردن

rate با ۸ رقم اعشار برمی‌گردد.
result برای تومان و ریال عدد صحیح، برای ارزها با ۴ رقم اعشار.
در طرح رایگان تبدیل با نرخ تأخیردار انجام می‌شود (meta.delayed_minutes).

خطاها

HTTP	code	معنا
400	`unknown_currency`	`from` یا `to` شناخته نشد (فیلد `param` می‌گوید کدام).
422	`validation_failed`	پارامتر نامعتبر (مثلاً amount منفی).

مبدل ارز

نمونه‌ها

گرد کردن

خطاها