دادهٔ آمادهٔ JSON برای قیمت فعلی و تاریخچهٔ روزانه بازار ایران؛ بدون ثبت‌نام و بدون API Key
Iran Market Data مجموعه‌ای عمومی از فایل‌های JSON برای دریافت قیمت دلار آزاد، یورو، طلا، سکه، تتر، رمزارزها، نفت، انرژی، قهوه، غلات و فلزات است. این مخزن برای وب‌سایت، اپلیکیشن، ربات، داشبورد، پروژهٔ دانشگاهی و تحلیل داده طراحی شده و برای استفاده از آن به ثبت‌نام، توکن، SDK یا اجرای scraper نیاز ندارید.
در خروجی فعلی، ۱٬۳۵۰ شناسهٔ canonical، ۹۵۵ نماد دارای قیمت فعلی و ۱۲۸ فایل تاریخچهٔ OHLC روزانه منتشر می‌شود. اعداد زنده و قابل اتکا همیشه در data/symbols.json و data/history/index.json قرار دارند.
داشبورد و مستندات زنده · راهنمای کامل نمادها · فهرست تاریخچه‌ها
برای دریافت قیمت‌های پرکاربرد بازار به تومان:
curl --fail --silent \
https://raw.githubusercontent.com/iran-market/iran-market.github.io/main/data/popular.jsonاین URL عمومی است، CORS دارد و مستقیماً در مرورگر یا کد قابل استفاده است:
https://raw.githubusercontent.com/iran-market/iran-market.github.io/main/data/popular.json
| فایل | محتوا | زمان به‌روزرسانی | لینک مستقیم |
|---|---|---|---|
popular.json |
دلار آزاد، یورو، پوند، طلای ۱۸ عیار، سکه امامی و تتر؛ مناسب شروع سریع | هر ۳۰ دقیقه | Raw GitHub |
latest-toman.json |
همهٔ قیمت‌های فعلی؛ دارایی‌های ریالی به تومان و دارایی‌های جهانی در ارز اصلی خودشان | هر ۳۰ دقیقه | Raw GitHub |
latest.json |
همهٔ قیمت‌های فعلی؛ دارایی‌های ریالی به ریال و دارایی‌های جهانی در ارز اصلی خودشان | هر ۳۰ دقیقه | Raw GitHub |
symbols.json |
مرجع شناسه‌ها، نام معتبر، دسته، واحد، وضعیت قیمت فعلی و مسیر تاریخچه | هر ۳۰ دقیقه | Raw GitHub |
history/index.json |
فهرست ماشین‌خوان تاریخچه‌ها، تعداد رکورد، ارز و بازهٔ زمانی هر نماد | فهرست هر ۳۰ دقیقه؛ فایل‌های تاریخچه روزانه | Raw GitHub |
history/{SYMBOL}.json |
کندل‌های OHLC روزانهٔ یک نماد، مرتب‌شده از قدیمی به جدید | روزانه | نمونهٔ دلار آزاد |
manifest.json |
فهرست فایل‌های منتشرشده، تعداد رکوردها و metadata انتشار | هر ۳۰ دقیقه | Raw GitHub |
مسیر پیشنهادی برای مصرف JSON، Raw GitHub است تا ترافیک فایل‌ها از سهمیهٔ پهنای باند GitHub Pages عبور نکند. Raw GitHub معمولاً حدود ۵ دقیقه cache می‌شود و برای قیمت‌های نیم‌ساعتی انتخاب مناسب‌تری است:
https://raw.githubusercontent.com/iran-market/iran-market.github.io/main/data/{FILE}
jsDelivr نیز به‌عنوان CDN جایگزین در دسترس است، اما ممکن است فایل شاخهٔmainرا حدود ۱۲ ساعت cache کند؛ بنابراین برای داده‌ای استفاده کنید که تأخیر بیشتر در تازه‌شدن آن قابل قبول است:
https://cdn.jsdelivr.net/gh/iran-market/iran-market.github.io@main/data/{FILE}
شناسه‌های عمومی پروژه مستقل از slug داخلی منبع هستند. برای نمونه، USD_IRR_FREE دلار بازار آزاد، GOLD_18K_IRR طلای ۱۸ عیار و COIN_EMAMI_IRR سکه امامی است. برای جلوگیری از خطای تطبیق، در کد خود همیشه از فیلد symbol استفاده کنید، نه نام نمایشی.
| بازار | نماد نمونه | تاریخچه مستقیم |
|---|---|---|
| دلار آزاد | USD_IRR_FREE | JSON |
| یورو آزاد | EUR_IRR_FREE | JSON |
| طلای ۱۸ عیار | GOLD_18K_IRR | JSON |
| سکه امامی | COIN_EMAMI_IRR | JSON |
| تتر ریالی | USDT_IRR | JSON |
| بیت‌کوین دلاری | BTC_USD | JSON |
| قهوه لندن | COMMODITY_LONDON_COFFEE | JSON |
فهرست کامل و قابل جست‌وجوی شناسه‌ها در راهنمای نمادها و نسخهٔ ماشین‌خوان آن در symbols.json قرار دارد. نام فارسی یا انگلیسی حدس زده نمی‌شود؛ اگر نام معتبر موجود نباشد مقدار آن null است و رابط وب خود symbol را نمایش می‌دهد.
const url = 'https://raw.githubusercontent.com/iran-market/iran-market.github.io/main/data/popular.json';
const response = await fetch(url);
if (!response.ok) {
throw new Error(`Iran Market request failed: ${response.status}`);
}
const payload = await response.json();
const dollar = payload.data.find(
(item) => item.symbol === 'USD_IRR_FREE',
);
console.log({
price: dollar.price,
currency: dollar.currency, // IRT یعنی تومان
marketTime: dollar.timestamp_tehran,
publishedAt: payload.meta.published_at,
stale: dollar.stale,
});import requests
url = "https://raw.githubusercontent.com/iran-market/iran-market.github.io/main/data/history/USD_IRR_FREE.json"
response = requests.get(url, timeout=20)
response.raise_for_status()
payload = response.json()
for candle in payload["data"][-7:]:
print(
candle["date_jalali"],
candle["open"],
candle["high"],
candle["low"],
candle["close"],
)
مسیر فایل‌ها را در کد hard-code نکنید. ابتدا history/index.json را بخوانید و سپس URL نماد موردنظر را از همان فهرست دریافت کنید:
const directory = await fetch(
'https://raw.githubusercontent.com/iran-market/iran-market.github.io/main/data/history/index.json',
).then((response) => response.json());
const coffee = directory.data.find(
(item) => item.symbol === 'COMMODITY_LONDON_COFFEE',
);
const history = await fetch(coffee.url).then((response) => response.json());
console.log(history.meta.currency, history.data.at(-1));{
"symbol": "USD_IRR_FREE",
"name_fa": "دلار آمریکا (بازار آزاد)",
"name_en": "US Dollar (open market)",
"category": "currency",
"currency": "IRT",
"price": 258465,
"high": 258520,
"low": 254660,
"change": 0,
"change_pct": 0,
"timestamp": "2026-09-30T20:30:00.000Z",
"timestamp_tehran": "2026-10-01T00:00:00+03:30",
"timestamp_jalali": "1405/07/09 00:00:00",
"checked_at": "2026-10-02T11:08:26.797Z",
"source": "tgju",
"stale": false,
"quality": []
}timestamp: زمان خود قیمت یا کندل در UTC.timestamp_tehran: همان زمان با منطقهٔ زمانی تهران.timestamp_jalaliوdate_jalali: نمایش جلالی برای رابط فارسی.checked_at: آخرین زمانی که سامانه وضعیت این قیمت را بررسی کرده است.meta.published_at: زمان ساخته‌شدن فایل عمومی؛ الزاماً زمان تغییر قیمت بازار نیست.
{
"t": "2011-11-25T20:30:00.000Z",
"t_tehran": "2011-11-26T00:00:00+03:30",
"date_jalali": "1390/09/05",
"open": 1370,
"high": 1370,
"low": 1370,
"close": 1370,
"volume": null,
"origin": "source",
"quality": []
}
رکوردهای تاریخچه صعودی هستند؛ یعنی قدیمی‌ترین کندل ابتدای آرایه و جدیدترین کندل انتهای آرایه است. بازهٔ پوشش برای هر نماد متفاوت است و باید از فیلدهای from و to در history/index.json خوانده شود. بعضی بازارها در مجموعهٔ فعلی تا سال ۲۰۱۰ میلادی سابقه دارند.
| دسته | تعداد فایل | نمونه‌ها |
|---|---|---|
| ارز آزاد | ۲۵ | دلار، یورو، پوند، درهم، لیر، ارزهای منطقه‌ای و… |
| طلا و فلزات گران‌بها | ۱۶ | طلای ۱۸ و ۲۴ عیار، آب‌شده، انس طلا، نقره و… |
| سکه | ۱۵ | بازار، تک‌فروشی و حباب انواع سکه |
| رمزارز | ۳۲ | جفت‌های دلاری و ریالی بیت‌کوین، تتر، سولانا و… |
| انرژی | ۶ | نفت برنت، گاز طبیعی، بنزین، سبد اوپک و… |
| کالا و فلز صنعتی | ۲۸ | قهوه، کاکائو، گندم، دام، مس، فولاد و… |
| جفت‌ارز جهانی | ۶ | EUR/USD، GBP/USD، USD/JPY و… |
IRRیعنی ریال ایران وIRTیعنی تومان ایران.- در
latest-toman.jsonفقط قیمت‌هایی که مبنای ریالی دارند به تومان تبدیل می‌شوند؛ قیمت جهانی قهوه، طلا، نفت یا فلزات باcurrency: USDدلاری باقی می‌ماند. - فیلد
currencyهر رکورد را بخوانید و واحد را از نام فایل حدس نزنید. stale: trueیعنی قیمت از آستانهٔ تازگی مورد انتظار قدیمی‌تر است؛ این وضعیت ممکن است هنگام تعطیلی بازار طبیعی باشد.- مقادیر
nullبه معنی «داده موجود نیست» هستند؛ آن‌ها را با صفر جایگزین نکنید. - قیمت فعلی هر ۳۰ دقیقه منتشر می‌شود و تاریخچه‌های کامل روزی یک‌بار بازسازی می‌شوند.
- نسخهٔ عمومی دادهٔ tick-by-tick یا real-time نیست؛ فاصلهٔ انتشار قیمت‌های فعلی ۳۰ دقیقه است.
- فرمت همهٔ خروجی‌ها UTF-8 JSON و دسترسی آن‌ها عمومی است.
- منبع فعلی داده TGJU است؛ منبع دیگری در این نسخه ادغام نشده است.
- این مخزن static data API است؛ پارامتر جست‌وجو، API key، حساب کاربری و rate-limit اختصاصی ندارد.
- برای JSON از Raw GitHub (پیشنهادی، cache حدود ۵ دقیقه) یا jsDelivr (جایگزین، cache حدود ۱۲ ساعت) استفاده کنید؛ GitHub Pages فقط میزبان رابط و مستندات وب است.
- دسترسی به Raw GitHub یا jsDelivr تابع پایداری و سیاست cache همان سرویس‌ها است و SLA تجاری ارائه نمی‌شود.
- قیمت‌ها صرفاً جهت اطلاع‌رسانی‌اند و توصیهٔ خرید یا فروش نیستند؛ برای استفادهٔ مالی یا حساس، داده را مستقلاً راستی‌آزمایی کنید.
اگر نماد اشتباه، واحد نادرست، دادهٔ قدیمی یا مشکل نمایشی پیدا کردید، یک Issue بسازید و symbol، URL فایل و نمونهٔ رکورد را بنویسید. فایل‌های داخل data/ خودکار تولید می‌شوند؛ برای اصلاح داده مستقیماً آن‌ها را ویرایش نکنید.
Iran Market Data provides public, no-auth JSON files for current and historical Iranian market data: free-market USD/IRR exchange rates, EUR and GBP, Iranian gold and coins, USDT, cryptocurrencies, energy, coffee, grains, and industrial metals. Current-price snapshots are published every 30 minutes, while selected daily OHLC histories are refreshed once per day. Start with popular.json, discover canonical identifiers in symbols.json, and enumerate available histories through history/index.json.
کد رابط، مستندات و مثال‌های این مخزن تحت مجوز MIT منتشر می‌شوند. دادهٔ بازار متعلق به تولیدکنندگان و ارائه‌دهندگان اصلی آن است.