Iran Market Rates API (LIVE 🔴)

API قیمت ارز و نرخ‌های زنده🔴 بازار ایران

نرخ‌های زنده بازار ایران — ارزهای بین‌المللی، طلا و سکه، و رمزارزها — از منبع معتبر TGJU استخراج شده و از طریق کش پرسرعت در حافظه ارائه می‌شود.

---

Currency - Live Iranian market rates API یک API آماده تولید و با عملکرد بالا است که نرخ‌های زنده بازار ایران را برای موارد زیر ارائه می‌دهد:

• 🌍 ارزهای فیات بین‌المللی (دلار آمریکا، یورو، درهم امارات، لیر ترکیه، پوند انگلیس و بیشتر)
• 🥇 طلا و سکه (شمش، میلی‌گرم و سکه‌های کلاسیک ایرانی)
• ₿ رمزارزها (بیت‌کوین، تتر، اتریوم و سایر دارایی‌های محبوب)

همه داده‌ها از منبع معتبر ایرانی TGJU استخراج، استانداردسازی و از طریق یک کش فوق‌العاده سریع در حافظه سرو می‌شوند که به‌صورت خودکار در پس‌زمینه به‌روزرسانی می‌شود. هیچ پایگاه داده‌ای استفاده نمی‌شود — هر پاسخ شامل زمان دقیق lastUpdated و پرچم warming است که تنها تا زمان تکمیل اولین استخراج موفق، برابر true می‌ماند.

چرا توسعه‌دهندگان RouteX Currency را انتخاب می‌کنند

• یک اندپوینت برای همه چیز یا نماهای فیلترشده (فقط فیات، فقط طلا، فقط رمزارز)
• جستجوی هوشمند در تمام ابزارها با کلمات کلیدی فارسی یا انگلیسی
• فرمت پاسخ یکسان همراه با مدیریت واضح موفقیت/خطا
• دوستانه با محدودیت نرخ و کدهای وضعیت HTTP مناسب
• بدون نیاز به پیکربندی — فقط اندپوینت‌ها را فراخوانی کنید و داده زنده دریافت کنید
• تحت مجوز MIT و آماده استفاده در محیط تولید

ایده‌آل برای داشبوردهای فین‌تک، مبدل‌های ارز، ربات‌های معاملاتی، اپلیکیشن‌های موبایل و هر برنامه‌ای که به داده‌های قابل‌اعتماد بازار ایران نیاز دارد.

---

📡 نمای کلی اندپوینت‌ها

متد	اندپوینت	توضیحات
GET	/api/market/all	تمام داده‌های بازار (فیات + طلا + رمزارز)
GET	/api/market/fiat-gold	ارزهای فیات + طلا و سکه
GET	/api/market/money-only	فقط ارزهای کشوری
GET	/api/market/gold-only	فقط طلا و سکه
GET	/api/market/crypto	فقط رمزارزها
GET	/api/market/search	جستجوی هوشمند بر اساس کلمه کلیدی

---

📚 مستندات دقیق اندپوینت‌ها

۱. دریافت تمام داده‌های بازار

GET /api/market/all

ارزهای فیات، طلا/سکه و رمزارزها را در یک پاسخ واحد برمی‌گرداند.

نمونه پاسخ (۲۰۰)

{
  "success": true,
  "warming": false,
  "lastUpdated": "2026-08-18T10:15:30.000Z",
  "currencies": [
    {
      "id": "price_dollar_rl",
      "name": "دلار",
      "price": "1,897,000",
      "change": "0.32%"
    }
  ],
  "goldAndCoins": [...],
  "crypto": [...]
}

---

۲. ارزهای فیات + طلا

GET /api/market/fiat-gold

قیمت ارزهای بین‌المللی و طلا/سکه (بدون رمزارز).

نمونه پاسخ (۲۰۰)

{
  "success": true,
  "warming": false,
  "lastUpdated": "2026-08-18T10:15:30.000Z",
  "data": {
    "currencies": [...],
    "goldAndCoins": [...],
    "crypto": []
  }
}

---

۳. فقط ارزهای کشوری

GET /api/market/money-only

فقط ارزهای فیات جهانی (دلار آمریکا، یورو، درهم، لیر و …).

---

۴. فقط طلا و سکه

GET /api/market/gold-only

شمش طلا، میلی‌گرم و سکه‌های کلاسیک ایرانی.

---

۵. فقط رمزارزها

GET /api/market/crypto

قیمت‌های زنده رمزارزها.

---

۶. جستجوی هوشمند

GET /api/market/search?q={keyword}

جستجو در ارزها، طلا و رمزارزها بر اساس نام یا کلمه کلیدی.

پارامترهای کوئری

پارامتر	الزامی	توضیحات	مثال
q	✅ بله	کلمه کلیدی جستجو (فارسی یا انگلیسی)	دلار، تتر، سکه

نمونه پاسخ (۲۰۰)

{
  "success": true,
  "warming": false,
  "query": "دلار",
  "count": 1,
  "results": [
    {
      "id": "price_dollar_rl",
      "name": "دلار",
      "price": "1,897,000",
      "change": "0.32%",
      "type": "money/fiat"
    }
  ],
  "lastUpdated": "2026-08-18T10:15:30.000Z"
}

---

📦 ساختار پاسخ‌ها

MarketItem

فیلد	نوع	توضیحات
id	string	شناسه یکتای ابزار
name	string	نام ابزار (معمولاً فارسی)
price	string	آخرین قیمت به‌صورت نمایش‌داده‌شده در منبع
change	string	درصد تغییر (ممکن است خالی باشد)

فیلدهای مشترک پاسخ

فیلد	نوع	توضیحات
success	boolean	آیا درخواست موفق بوده است
warming	boolean	فقط تا زمان تکمیل اولین استخراج برابر true است
lastUpdated	string | null	زمان‌سنج ISO-8601 از لحظه ثبت داده‌ها

---

💡 نکات استفاده

• همیشه پرچم warming را بررسی کنید — اگر true باشد، ممکن است داده‌ها هنوز در حال بارگذاری باشند.
• از lastUpdated برای نمایش تازگی داده‌ها به کاربران استفاده کنید.
• وقتی فقط به یک دسته نیاز دارید، از اندپوینت‌های فیلترشده (money-only، gold-only، crypto) استفاده کنید — حجم پاسخ کمتر می‌شود.
• اندپوینت جستجو برای قابلیت‌های تکمیل خودکار یا «جستجو بر اساس نام» عالی است.

---

🌟 آماده یکپارچه‌سازی هستید؟

فقط یک اندپوینت را انتخاب کنید و در چند ثانیه داده‌های زنده بازار ایران را دریافت کنید.

کدنویسی لذت‌بخش! 🚀