تقویم معاملاتی چیست؟

در API روشا: /v1/calendar

تقویم معاملاتی می‌گوید بازار در کدام روزها باز بوده است. بورس تهران و فرابورس از شنبه تا چهارشنبه معامله دارند. پنجشنبه، جمعه و تعطیلات رسمی کشور بازار بسته است. گاهی هم بازار به دلایل پیش‌بینی‌نشده بسته می‌شود.

بخشی از تعطیلات رسمی ایران بر اساس تقویم قمری است و تاریخ شمسی آن‌ها هر سال جابه‌جا می‌شود. پس نمی‌توان تقویم معاملاتی سال‌های آینده را با یک قاعدهٔ ثابت ساخت.

چرا برنامه به آن نیاز دارد؟

• شمردن روزها. «۲۰ روز معاملاتی پیش» با «۲۰ روز پیش» فرق دارد.
• تشخیص دادهٔ جاافتاده. اگر بازار باز بوده و نمادی ردیف ندارد، یا نماد متوقف بوده یا داده نرسیده است.
• زمان‌بندی. برنامهٔ همگام‌سازی در روز تعطیل لازم نیست اجرا شود.
• هم‌ترازکردن سری‌ها. برای مقایسهٔ چند نماد، همه را روی روزهای معاملاتی بازار هم‌تراز کنید.

چطور از روشا بگیرم؟

/v1/calendar روزهای معاملاتی یک بازه را برمی‌گرداند. start و end هر دو لازم هستند:

curl "https://poolick.ir/v1/calendar?start=2026-11-01&end=2026-11-14" \
  -H "Authorization: Bearer $ROSHA_KEY"

پاسخ واقعی:

["2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-07",
 "2026-11-08","2026-11-09","2026-11-10","2026-11-11"]

پنجشنبه و جمعه (۵ و ۶ نوامبر) در فهرست نیستند. تاریخ ورودی می‌تواند شمسی باشد، مثل start=1405-08-10.

سه نکته:

• این فهرست از روزهایی ساخته می‌شود که دادهٔ بازار دارند. پس فقط گذشته را می‌گوید و روزهای آینده را پیش‌بینی نمی‌کند.
• روز جاری پس از به‌روزرسانی پایان روز (ساعت ۱۸:۱۵ تهران) به فهرست اضافه می‌شود.
• باز بودن بازار به معنی معامله‌شدن هر نماد نیست. نماد متوقف در آن روز volume صفر دارد.

این نقطهٔ پایانی با هر کلید معتبر باز است و در MCP ابزار get_trading_days همین داده را می‌دهد. تقویم هر سال در صفحهٔ تقویم و مرجع در تقویم معاملاتی است.