به‌روزرسانی داده‌ها
دادهٔ روزانهٔ بورس و فرابورس هر روز معاملاتی ساعت ۱۸:۱۵ به وقت تهران تازه می‌شود، quote زنده در ساعات بازار هر ۳۰ ثانیه، و ارقام صندوق‌ها هر ساعت از ۱۴:۳۰ تا ۲۲:۳۰. همهٔ زمان‌های این صفحه به وقت تهران (Asia/Tehran، UTC+03:30) است.
هر داده چه زمانی تازه می‌شود؟
Section titled “هر داده چه زمانی تازه می‌شود؟”| داده | endpointها | زمان به‌روزرسانی (وقت تهران) |
|---|---|---|
| quote زنده و عمق بازار | /v1/instruments/{ref}/quote |
هر ۳۰ ثانیه تا ۱۳:۰۵؛ سپس هر ۲ دقیقه تا ۱۸:۰۵ |
| قیمت روزانه، حقیقی و حقوقی، رویدادهای تعدیل، شاخص‌ها و ریزمعاملات | /daily، /client-type، /adjustments، /v1/indices/{ref}/daily، /trades، /bars |
۱۸:۱۵، شنبه تا چهارشنبه |
| ISIN، نام‌های لاتین و گروه صنعت | /v1/instruments، /v1/instruments/{ref} |
پنجشنبه ۰۳:۰۰ |
| صندوق‌ها: آخرین ارقام | /v1/funds، /v1/funds/{ref}، /v1/funds/{ref}/snapshots، ردیف تازهٔ /v1/funds/{ref}/history |
هر ساعت از ۱۴:۳۰ تا ۲۲:۳۰، همهٔ روزها |
| صندوق‌ها: سابقهٔ کامل، شناسنامه و سودهای تقسیمی | /v1/funds/{ref}/history، /v1/funds/{ref} |
جمعه ۰۲:۰۰ |
این جدول زمان‌بندی جاری تا آبان ۱۴۰۵ است. زمان آخرین به‌روزرسانی واقعی هر داده را در وضعیت سرویس ببینید.
«ارقام آخرین روز ممکن است عوض شود» یعنی چه؟
Section titled “«ارقام آخرین روز ممکن است عوض شود» یعنی چه؟”یعنی ردیف تازه‌ترین روز پس از ۱۸:۱۵ هنوز قطعی نیست. TSETMC بعضی ارقام پایان روز را دیر منتشر می‌کند؛ پس دادهٔ آخرین روز ممکن است تا اجرای بعدیِ به‌روزرسانی تغییر کند.
اگر داده را ذخیره می‌کنید:
- ردیف‌ها را با upsert بنویسید، نه insert.
- در هر همگام‌سازی، چند روز آخر را دوباره بگیرید.
کد کامل در همگام‌سازی روزانه با پایگاه داده است.
quote چقدر تازه است؟
Section titled “quote چقدر تازه است؟”در ساعات بازار، quote زنده حداکثر ۳۰ ثانیه قدیمی است (پس از ۱۳:۰۵ حداکثر ۲ دقیقه) و فیلد ts زمان همان snapshot را می‌گوید. فاصلهٔ ۲ دقیقه‌ای تا ۱۸:۰۵ برای صندوق‌های قابل معامله است که تا حدود ساعت ۱۸ معامله می‌شوند.
پس از پایان جلسه، snapshot زنده منقضی می‌شود و quote آخرین ردیف روزانه را با "source": "daily" برمی‌گرداند. همیشه source را بررسی کنید. شرح در دادهٔ لحظه‌ای.
ریزمعاملات چه زمانی می‌رسد؟
Section titled “ریزمعاملات چه زمانی می‌رسد؟”ریزمعاملات و کندل‌های درون‌روز هر روز با دادهٔ پایان روز، ساعت ۱۸:۱۵، ذخیره می‌شوند. /trades و /bars جریان زندهٔ معاملات نیستند.
ریزمعاملات فقط برای روزهایی هست که در پایان همان روز دریافت یا بعداً بازیابی شده‌اند. پاسخ خالی یعنی ریزمعاملات آن روز ذخیره نشده است، نه اینکه نماد معامله نشده است.
دادهٔ صندوق‌ها چطور تازه می‌شود؟
Section titled “دادهٔ صندوق‌ها چطور تازه می‌شود؟”صندوق‌ها دو چرخه دارند: ارقام روز به‌صورت ساعتی و سابقهٔ کامل به‌صورت هفتگی.
- ساعتی (۱۴:۳۰ تا ۲۲:۳۰، همهٔ روزها): فیپیران ارقام را پس از حدود ۱۴:۳۰ منتشر می‌کند و بسیاری از صندوق‌ها دیر منتشر می‌کنند. ردیف‌هایی که این چرخه به
/historyاضافه می‌کند"source": "snapshot"دارند و فقط NAV، خالص دارایی، بازده‌ها و ترکیب دارایی را دارند. - هفتگی (جمعه ۰۲:۰۰): سابقهٔ کامل از نو ساخته می‌شود، چون فیپیران ارقام گذشته را اصلاح می‌کند. ردیف‌های
snapshotبا ردیف"source": "chart"جایگزین می‌شوند که واحدهای صادر و ابطال‌شده، ترکیب مالکیت و آلفا و بتا را هم دارد. - آلفا و بتا: حدود هفت هفته از فیپیران عقب است؛ در ردیف‌های اخیر
nullاست. latest: آخرین ارقام در/v1/fundsو/v1/funds/{ref}برای صندوق‌هایی که دیر منتشر می‌کنند ممکن است چند روز از/historyعقب باشد. برای تازه‌ترین رقم/history?limit=1را بگیرید.
اگر سابقهٔ صندوق‌ها را ذخیره می‌کنید، هفته‌ای یک بار، پس از جمعه ۰۲:۰۰، آن را کامل دوباره بخوانید.
مشخصات نماد چه زمانی کامل می‌شود؟
Section titled “مشخصات نماد چه زمانی کامل می‌شود؟”فیلدهای isin، ticker_latin، name_latin و company_name با همگام‌سازی هفتگی هویت نمادها، پنجشنبه ساعت ۰۳:۰۰، پر می‌شوند. برای نماد تازه‌وارد تا آن زمان ممکن است null باشند.
کار زمان‌بندی‌شده‌ام را چه ساعتی اجرا کنم؟
Section titled “کار زمان‌بندی‌شده‌ام را چه ساعتی اجرا کنم؟”| کار | زمان پیشنهادی (وقت تهران) |
|---|---|
| همگام‌سازی قیمت روزانه، حقیقی و حقوقی و شاخص‌ها | شنبه تا چهارشنبه، پس از ۱۸:۱۵ |
| خواندن ارقام روز صندوق‌ها | پس از ۲۲:۳۰ |
| بازخوانی کامل سابقهٔ صندوق‌ها | هفته‌ای یک بار، پس از جمعه ۰۲:۰۰ |
| خواندن quote زنده | در ساعات بازار، نه بیشتر از هر ۳۰ ثانیه یک بار برای هر نماد |
از کجا بفهمم داده امروز رسیده است؟
Section titled “از کجا بفهمم داده امروز رسیده است؟”سه راه دارید:
- وضعیت سرویس آخرین روز دادهٔ روزانه و زمان آخرین اجرای پایان روز را نشان می‌دهد.
GET /v1/instruments/{ref}/daily?limit=1را بگیرید وdردیف را با تاریخ امروز مقایسه کنید.GET /v1/calendarرا برای بازه‌ای که امروز را در بر دارد بگیرید.
صفحهٔ اصلی · قیمت‌ها · وضعیت · پنل · پشتیبانی
داده‌ها توصیهٔ سرمایه‌گذاری نیست. سلب مسئولیت