mortezapour / finpy-tse

A Python Package to Access Tehran Stock Exchange Historical and Real-Time Data

این ماژول با هدف دسترسی به اطلاعات مربوط به سهام بورس ایران در محیط برنامه‌نویسی پایتون توسعه یافته است. بنابراین شما می‌توانید به راحتی به داده‌های مدنظر خود دسترسی داشته باشید و در توسعه مدل‌های تحلیلی خود از تحلیل تکنیکال گرفته تا تحلیل‌های عددی و یا مبتنی بر ماشین لرنینگ، استفاده کنید. این ماژول از جامعیت و انعطاف‌پذیری فوق‌العاده‌ای در دسترسی به دیتا و پیش‌پردازش آن برخوردار بوده و می‌تواند جایگزین رایگان و مناسبی برای یک اشتراک پولی، به منظور دسترسی به داده‌های بازار سهام باشد. داده‌های خروجی توابع این ماژول، دیتافریم پانداز بوده و شما می‌توانید از آن به عنوان ورودی سایر ماژول‌های آماده موجود از ماژول‌های مصورسازی گرفته تا ماژول‌های تحلیل تکنیکال، مدیریت پرتفوی و ... استفاده کنید

 

: ازجمله ویژگی‌های مهم این ماژول می‌توان به موارد زیر اشاره کرد

قابلیت دسترسی به داده‌های یک سهم با استفاده از نماد يا نام کامل فارسی   <---  
قابلیت انجام تعدیل قیمت به صورت یکجا با احتساب انواع افزایش سرمایه و پرداخت سود نقدی   <---  
هوشمندی در تشخیص جابجایی یک نماد بین بازارهای مختلف و یکپارچه سازی همه سوابق نمادهای دارای جابجایی   <---  
قابلیت دسترسی به سوابق همه شاخص‌های بازار بورس و هوشمندی در تشخیص اشتباهات املایی و نگارشی عناوین شاخص صنایع بورسی   <---  
قابلیت دسترسی به سابقه داده‌های درون‌روز یک نماد شامل عمق بازار و ریز معاملات   <---  
قابلیت دسترسی و رصد لحظه‌ای دیده‌بان و عمق بازار در ساعت انجام معاملات در بازار   <---  
قابلیت تهیه لیست جامعی از مشخصات همه سهم‌های بازار   <---  
قابلیت دانلود دسته‌جمعی سابقه قیمت لیستی از سهم‌ها و ساخت پنل قیمت پایانی تعدیل شده برای آنها   <---  
قابلیت دسترسی به سابقه ۱۰ ساله قیمت دلار بازار آزاد   <---  
خروجی سازگار با دیتافریم پانداز و قابلیت فیلترینگ زمانی مجدد بر اساس تاریخ شمسی   <---  
قابلیت ارائه تاریخ شمسی، میلادی و نام ایام هفته برای داده‌های روزانه   <---  

 

این ماژول دارای یک کتابچه راهنمای فارسی است که در آن همه توابع ماژول به همراه مثال ذکر شده است. برای دسترسی به این کتابچه راهنما میتوانید از این صفحه استفاده کنید

همچین می‌توانید از طریق این لینک به آدرس تلگرامی ما دسترسی داشته باشید

 

 

نصب ماژول

pip install finpy-tse

 

فراخوانی ماژول

import finpy_tse as fpy

 

دریافت سابقه اطلاعات روزانه یک نماد

---

: دریافت سابقه قیمت

fpy.Get_Price_History(
    stock='خودرو',
    start_date='1400-01-01',
    end_date='1401-01-01',
    ignore_date=False,
    adjust_price=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه حقیقی-حقوقی

fpy.Get_RI_History(
    stock='خودرو',
    start_date='1400-01-01',
    end_date='1401-01-01',
    ignore_date=False,
    show_weekday=False,
    double_date=False)

 

دریافت سابقه اطلاعات درون‌ریز یک نماد

---

: دریافت سابقه ریز معاملات

fpy.Get_IntradayTrades_History(
    stock='وخارزم',
    start_date='1400-09-15',
    end_date='1400-12-29',
    jalali_date=True,
    combined_datatime=False,
    show_progress=True)

: دریافت سابقه عمق بازار

fpy.Get_IntradayOB_History(
    stock='کرمان',
    start_date='1400-08-01',
    end_date='1400-08-01',
    jalali_date=True,
    combined_datatime=False,
    show_progress=True)

: دریافت سابقه ارزش صف در زمان بسته‌شدن بازار

fpy.Get_Queue_History(
    stock='وخارزم',
    start_date='1400-09-15',
    end_date='1400-12-29',
    show_per_capita=True,
    show_weekday=False,
    double_date=False,
    show_progress=True)

 

دریافت سابقه روزانه شاخص‌های بازار بورس

---

: دریافت سابقه شاخص کل

fpy.Get_CWI_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص کل هم‌وزن

fpy.Get_EWI_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=True,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص قیمت وزنی-ارزشی

fpy.Get_CWPI_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص قیمت هم‌وزن

fpy.Get_EWPI_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص سهام آزاد شناور

fpy.Get_FFI_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص بازار اول

fpy.Get_MKT1I_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص بازار دوم

fpy.Get_MKT2I_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص صنعت

fpy.Get_INDI_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص 50 شرکت فعال‌تر

fpy.Get_ACT50_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص 30 شرکت بزرگ

fpy.Get_LCI30_History(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

: دریافت سابقه شاخص صنایع بورسی

fpy.Get_SectorIndex_History(
    sector='خودرو',
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    just_adj_close=False,
    show_weekday=False,
    double_date=False)

 

اطلاعات لحظه‌ای بازار

---

: دریافت اطلاعات لحظه‌ای بازار

fpy.Get_MarketWatch(
    save_excel=True,
    save_path='D:/FinPy-TSE Data/MarketWatch')

 

دانلود دسته‌جمعی و پنل قیمت

---

: دریافت لیست جامع سهم‌ها

fpy.Build_Market_StockList(
    bourse=True,
    farabourse=True,
    payeh=True,
    detailed_list=True,
    show_progress=True,
    save_excel=True,
    save_csv=True,
    save_path='D:/FinPy-TSE Data/')

: دانلود دسته‌جمعی اطلاعات و ساخت پنل قیمت

fpy.Build_PricePanel(
    stock_list,
    jalali_date=True,
    save_excel=True,
    save_path='D:/FinPy-TSE Data/Price Panel/')

 

دلار آمریکا

---

: دسترسی به سابقه روزانه قیمت دلار

fpy.Get_USD_RIAL(
    start_date='1395-01-01',
    end_date='1400-12-29',
    ignore_date=False,
    show_weekday=False,
    double_date=False)