Iran Market Rates API (LIVE 🔴)

🇮🇷 Currency — Live🔴 Iran Market Rates API

Live Iranian market rates — international fiat currencies, gold & coins, and cryptocurrencies — scraped from TGJU and served from a high-speed in-memory cache.

---

Currency - Live Iranian market rates API is a production-ready, high-performance API that delivers live Iranian market rates for:

• 🌍 International Fiat Currencies (USD, EUR, AED, TRY, GBP, and more)
• 🥇 Gold & Coins (bullion, miligrams, classic Iranian coins)
• ₿ Cryptocurrencies (Bitcoin, Tether, Ethereum, and other popular assets)

All data is scraped from the trusted Iranian source TGJU, normalized, and served from a blazing-fast in-memory cache that refreshes automatically in the background. No database is used — every response includes a precise lastUpdated timestamp and a warming flag that is true only until the first successful scrape completes.

Why developers choose RouteX Currency

• One endpoint for everything or filtered views (fiat-only, gold-only, crypto-only)
• Smart search across all instruments by Persian or English keywords
• Consistent response format with clear success/error handling
• Rate-limit friendly with proper HTTP status codes
• Zero configuration — just call the endpoints and get live data
• MIT licensed and production-ready

Perfect for fintech dashboards, currency converters, trading bots, mobile apps, and any application that needs reliable Iranian market data.

---

📡 Endpoints Overview

Method	Endpoint	Description
GET	/api/market/all	All market data (fiat + gold + crypto)
GET	/api/market/fiat-gold	Fiat currencies + gold & coins
GET	/api/market/money-only	Country currencies only
GET	/api/market/gold-only	Gold & coins only
GET	/api/market/crypto	Cryptocurrencies only
GET	/api/market/search	Smart search by keyword

---

📚 Detailed Endpoint Documentation

1. Get All Market Data

GET /api/market/all

Returns fiat currencies, gold/coins, and cryptocurrencies in a single payload.

Response Example (200)

{
  "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": [...]
}

---

2. Fiat Currencies + Gold

GET /api/market/fiat-gold

International currencies and gold/coin prices (excludes crypto).

Response Example (200)

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

---

3. Country Currencies Only

GET /api/market/money-only

Global fiat currencies only (USD, EUR, AED, TRY, …).

---

4. Gold & Coins Only

GET /api/market/gold-only

Gold bullion, miligrams, and classic Iranian coins.

---

5. Cryptocurrencies Only

GET /api/market/crypto

Live cryptocurrency prices.

---

6. Smart Search

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

Search across currencies, gold, and crypto by name or keyword.

Query Parameters

Parameter	Required	Description	Example
q	✅ Yes	Search keyword (Persian or English)	دلار, تتر, سکه

Response Example (200)

{
  "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"
}

---

📦 Response Schemas

MarketItem

Field	Type	Description
id	string	Unique instrument identifier
name	string	Instrument name (usually Persian)
price	string	Latest price as displayed by source
change	string	Percentage change (may be empty)

Common Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
warming	boolean	true only until the first scrape completes
lastUpdated	string | null	ISO-8601 timestamp of the data snapshot

---

💡 Usage Tips

• Always check the warming flag — if true, data may still be loading.
• Use lastUpdated to display freshness to your users.
• Prefer filtered endpoints (money-only, gold-only, crypto) when you only need one category — smaller payloads.
• The search endpoint is perfect for autocomplete or “find by name” features.

---

🌟 Ready to integrate?

Just pick an endpoint and start receiving live Iranian market data in seconds.

Happy coding! 🚀