Metadata-Version: 2.1
Name: tsetmc
Version: 0.26.0
Summary: a library to retrieve data from tsetmc.com website
Home-page: https://github.com/5j9/tsetmc
Author: 5j9
Author-email: 5j9@users.noreply.github.com
License: GNU General Public License v3 (GPLv3)
Description: A Python library to fetch data from http://tsetmc.com.
        
        Note: The API is provisional and may change without deprecation.
        
        Installation
        ------------
        Requires Python 3.9+.
        
        ``pip install tsetmc``
        
        Overview
        --------
        
        The ``Instrument`` class provides methods for getting information about an instrument. The following code block tries to demonstrate its capabilities.
        
        Please review the abbreviations described at https://cdn.tsetmc.com/Site.aspx?ParTree=151713 . Many of the parameters/keys/column-names/etc are chosen from those abbreviations. If you can't figure out the meaning of any of them, please open an issue.
        
        .. code-block:: python
        
            >>> from tsetmc import Instrument
            >>> inst = Instrument.from_l18('فملی')
            >>> # getting the static data available in the main page of the symbol
            >>> inst.get_page_data(general=True, trade_history=True, related_companies=True)
            {'bvol': 9803922,
             'cisin': 'IRO1MSMI0000',
             'cs': 27,
             'eps': 1339,
             'sps': 2452.07,
             'flow': 1,
             'free_float': 33,
             'group_code': 'N1',
             'isin': 'IRO1MSMI0001',
             'l18': 'فملی',
             'l30': 'ملی\u200c صنایع\u200c مس\u200c ایران\u200c',
             'flow_name': 'بازار اول (تابلوی اصلی) بورس',
             'month_average_volume': 80515596,
             'sector_name': 'فلزات اساسی',
             'sector_pe': 8.9,
             'tmax': 12650.0,
             'tmin': 11450.0,
             'week_max': 12380.0,
             'week_min': 11770.0,
             'year_max': 39810.0,
             'year_min': 0.0,
             'z': 200000000000,
             'trade_history':                  pc       py     pmin     pmax    tno       tvol          tval
             date
             2021-07-04  12050.0  12040.0  11770.0  12190.0  10504   60085175  7.239613e+11
             2021-07-03  12040.0  12240.0  11800.0  12380.0  14905   88571671  1.066283e+12
             2021-06-30  12240.0  12240.0  12180.0  12370.0  11639   61924440  7.580286e+11
             2021-06-29  12240.0  12140.0  12110.0  12410.0  13153   80738158  9.886263e+11
             2021-06-28  12140.0  12220.0  11990.0  12290.0  12556   69479692  8.434176e+11
             2021-06-27  12220.0  12420.0  12040.0  12440.0  18830   93937722  1.148373e+12
             2021-06-26  12420.0  12310.0  12120.0  12600.0  25260  155751582  1.934123e+12
             2021-06-23  12310.0  11830.0  12020.0  12420.0  23635  204263514  2.514120e+12
             2021-06-22  11830.0  11540.0  11530.0  12110.0  24234  170353210  2.014437e+12,
             'related_companies': [[46348559193224090, 'فولاد', 'فولاد مبارکه اصفهان'],
              [35425587644337450, 'فملی', 'ملی\u200c صنایع\u200c مس\u200c ایران\u200c'],
              [9211775239375291, 'ذوب', 'سهامی ذوب آهن  اصفهان'],
              [55373808401388162, 'فتوسا', 'تولید و توسعه سرب روی ایرانیان'],
              [66701874099226162, 'فاسمین', 'کالسیمین\u200c'],
              [43716452378323683, 'فزرین', 'زرین معدن آسیا'],
              [41302553376174581, 'فجر', 'فولاد امیرکبیرکاشان'],
              [28864540805361867, 'فخوز', 'فولاد  خوزستان'],
              [29974853866926823, 'فروی', 'ذوب روی اصفهان'],
              [54277068923045214, 'فسرب', 'ملی\u200c سرب\u200cوروی\u200c ایران\u200c'],
              [43545527030854340, 'کویر', 'تولیدی فولاد سپید فراب کویر'],
              [60350996279289099, 'کاوه', 'فولاد کاوه جنوب کیش'],
              [66514709341259550, 'فوکا', 'فولاد کاویان'],
              [408934423224097, 'فرآور', 'فرآوری\u200cموادمعدنی\u200cایران\u200c'],
              [8977441217024425, 'فسپا', 'گروه\u200cصنعتی\u200cسپاهان\u200c'],
              [18004480270695404, 'فمراد', 'آلومراد'],
              [66772024744156373, 'فباهنر', 'مس\u200c شهیدباهنر'],
              [27814844870305607, 'کیمیا', 'معدنی کیمیای زنجان گستران'],
              [70498485598181604, 'هرمز', 'فولاد هرمزگان جنوب'],
              [48623320733330408, 'فلوله', 'لوله\u200cوماشین\u200cسازی\u200cایران\u200c'],
              [24018878640527909, 'میدکو', 'هلدینگ صنایع  معدنی خاورمیانه'],
              [12874072841236826, 'فسازان', 'غلتک سازان سپاهان'],
              [47232550823972469, 'وتوکا', 'سرمایه\u200cگذاری\u200cتوکافولاد(هلدینگ'],
              [14800142337291217, 'فولای', 'صنایع فولاد آلیاژی یزد'],
              [59266699437480384, 'ارفع', 'شرکت آهن و فولاد ارفع'],
              [4733285133017464, 'فخاس', 'فولاد خراسان'],
              [67170215467608124, 'زنگان', 'صنعت روی زنگان'],
              [65004959184388996, 'فایرا', 'آلومینیوم\u200cایران\u200c'],
              [57875847776839336, 'فنوال', 'نورد آلومینیوم\u200c'],
              [54419429862704331, 'فروس', 'فروسیلیس\u200c ایران\u200c'],
              [40808043719554948, 'فولاژ', 'فولاد آلیاژی ایران'],
              [44296315953738727, 'فاهواز', 'نورد و لوله اهواز'],
              [68488673556087148, 'فپنتا', 'سپنتا'],
              [8725363201030474, 'فگستر', 'گسترش صنایع روی ایرانیان'],
              [19367527798307032, 'فالوم', 'آلومتک\u200c'],
              [41713045190742691, 'وسدید', 'گروه \u200cصنعتی\u200cسدید'],
              [56324206651661881, 'فنورد', 'نوردوقطعات\u200c فولادی\u200c'],
              [35445515321658835, 'فماک', 'ماداکتو استیل کرد'],
              [59342912854668427, 'فنفت', 'صنایع تجهیزات نفت'],
              [20966291817819448, 'فسدید', 'لوله\u200cوتجهیزات\u200c سدید - ورشکسته'],
              [66021783818850713, 'فافزا', 'فولاد افزا سپاهان'],
              [26881786652328215, 'زرند', 'فولاد زرند'],
              [41867071915439180, 'آلومینیوم جنوب', 'مجتمع آلومینیوم جنوب'],
              [58903026391426893, 'سیرجان', 'فولاد سیرجان'],
              [42171673792069321, 'زیسکو', 'فولاد زرند ایرانیان'],
              [48175603054578540, 'اسفراین', 'مجتمع صنعتی اسفراین'],
              [67535111875054076, 'پارس متال ', 'پارس متال'],
              [40012411719639360, 'سیسکو', 'فولاد سیرجان ایرانیان'],
              [357086043812735, 'فولاد تربت', 'فولاد تربت حیدریه'],
              [37284308569715577, 'فسبزوار', 'پارس فولاد سبزوار'],
              [68604686987554533, 'فماکح', 'ح . ماداکتو استیل کرد'],
              [45507655586782998, 'فجهان', 'مجتمع جهان فولاد سیرجان'],
              [44846320603450383, 'فروسیل', 'فروسیلیسیم خمین']]}
            >>> # getting the latest price information
            >>> inst.get_info()
            {'timestamp': '12:30:00',
             'status': 'A ',
             'last_info_datetime': datetime.datetime(2021, 7, 5, 12, 30),
             'pl': 12250,
             'pc': 12210,
             'pf': 12140,
             'py': 12050,
             'pmin': 12340,
             'pmax': 12100,
             'tno': 10904,
             'tvol': 57477120,
             'tval': 701852286450}
            >>> # getting the daily trade history for the last n days (as a DataFrame)
            >>> inst.get_trade_history(top=2)
                         pmax     pmin       pc  ...          tval       tvol    tno
            date                                 ...
            20210120  10400.0  10120.0  10380.0  ...  4.984848e+11   48013394   7284
            20210119  10380.0   9400.0   9910.0  ...  2.649416e+12  267389256  36765
            [2 rows x 9 columns]
            >>> # getting legal/natural client types (the result is a DataFrame)
            >>> inst.get_client_type()
                        n_buy_count  l_buy_count  ...  n_sell_value  l_sell_value
            date                                  ...
            2021-07-04         4447           14  ...  586457311950  137504028420
            2021-07-03         5890           23  ...  994298662870   71984465160
            2021-06-30         5032           19  ...  637609524840  120419036770
            2021-06-29         5851           12  ...  562034366100  426591980560
            2021-06-28         5349           17  ...  767532788130   75884839930
                             ...          ...  ...           ...           ...
            2008-12-02            0            1  ...         53664             0
            2008-12-01            0            1  ...             0        212750
            2008-11-30            2            1  ...       2565810             0
            2008-11-29            1            0  ...       4521000             0
            2008-11-26            1            1  ...       1487409         46600
            [2715 rows x 12 columns]
            >>> # getting the data in identification (شناسه) tab of the symbol
            >>> inst.get_identification()  # the result is a DataFrame
                                                           1
            0
            کد 12 رقمی نماد                     IRO1MSMI0001
            کد 5 رقمی نماد                             MSMI1
            نام لاتین شرکت                   S*I. N. C. Ind.
            کد 4 رقمی شرکت                              MSMI
            نام شرکت                 ملی‌ صنایع‌ مس‌ ایران‌‌
            نماد فارسی                                  فملی
            نماد 30 رقمی فارسی        ملی‌ صنایع‌ مس‌ ایران‌
            کد 12 رقمی شرکت                     IRO1MSMI0000
            بازار               بازار اول (تابلوی اصلی) بورس
            >>> # getting the share/unit holders
            >>> inst.get_holders()
                                                سهامدار/دارنده  ...            id_cisin
            0    سازمان توسعه ونوسازی معادن وصنایع معدنی ایران  ...    104,IRO1MSMI0000
            1    موسسه صندوق بازنشستگی شرکت ملی صنایع مس ایران  ...    770,IRO1MSMI0000
            2           شرکت سرمایه گذاری صدرتاءمین-سهامی عام-  ...    492,IRO1MSMI0000
            3   شرکت سرمایه گذاری توسعه معادن وفلزات-سهامی عام  ...    460,IRO1MSMI0000
            4                          شرکت صبامیهن-سهامی خاص-  ...  48312,IRO1MSMI0000
            5                     شرکت س اتهران س.خ-م ک م ف ع-  ...   1064,IRO1MSMI0000
            6               شرکت س اخراسان رضوی س.خ-م ک م ف ع-  ...   1065,IRO1MSMI0000
            7         شرکت واسط مالی آذرچهارم-بامسئولیت محدود-  ...  60545,IRO1MSMI0000
            8            شرکت سرمایه گذاری آتیه صبا-سهامی خاص-  ...    788,IRO1MSMI0000
            9      موسسه صندوق بازنشستگی،وظیفه،ازکارافتادگی وپ  ...   7638,IRO1MSMI0000
            10           شرکت سرمایه گذاری فرهنگیان-سهامی خاص-  ...    515,IRO1MSMI0000
            11        شرکت توسعه ومدیریت سرمایه صبا-سهامی خاص-  ...  22650,IRO1MSMI0000
            12    شرکت سرمایه گذاری آتیه اندیشان مس-سهامی عام-  ...    413,IRO1MSMI0000
            13                     شرکت س افارس س.خ-م ک م ف ع-  ...   2674,IRO1MSMI0000
            14                  شرکت س اخوزستان س.خ-م ک م ف ع-  ...   2662,IRO1MSMI0000
            15                   شرکت س ااصفهان س.خ-م ک م ف ع-  ...   1063,IRO1MSMI0000
            16           شرکت س اآذربایجان شرقی س.خ-م ک م ف ع-  ...   2663,IRO1MSMI0000
            17                 شرکت س امازندران س.خ-م ک م ف ع-  ...   2675,IRO1MSMI0000
            18                    شرکت س اکرمان س.خ-م ک م ف ع-  ...   2665,IRO1MSMI0000
            19       موسسه صندوق بیمه اجتماعی روستائیان وعشایر  ...    771,IRO1MSMI0000
            20      شرکت گروه توسعه مالی مهرآیندگان-سهامی عام-  ...  21630,IRO1MSMI0000
            [21 rows x 5 columns]
            >>> # getting information of a specific share/unit holder
            >>> inst.get_holder('21630,IRO1MSMI0000', history=True, other_holdings=True)
            (                shares
             date
             2021-02-17  2003857980
             2021-02-18  2003857980
             2021-02-21  2003857980
             2021-02-22  2003857980
             2021-02-23  2003857980
             ...                ...
             2021-06-29  2003857980
             2021-06-30  2003857980
             2021-07-01  2003857980
             2021-07-04  2003857980
             2021-07-05  2003857980
        
             [90 rows x 1 columns],
                                                          name      shares  percent
             ins_code
             778253364357513                          بانک ملت  4161561525     2.00
             26014913469567886       سرمایه‌گذاری‌غدیر(هلدینگ‌  3356161798     4.66
             70270965300262393                      بیمه البرز  2805270000    19.44
             35700344742885862            معدنی و صنعتی گل گهر  2093472351     2.81
             35425587644337450          ملی‌ صنایع‌ مس‌ ایران‌  2003857980     1.00
             47302318535715632                بانک‌اقتصادنوین‌  1242200000     4.08
             45050389997905274                       بانک سینا  1015663732     4.00
             57309221039930244  سرمایه گذاری توسعه صنعت وتجارت   978026662    16.30
             29860265627578401                        بیمه  ما   623740333    15.59
             47996917271187218                 بانک‌ کارآفرین‌   500000000     1.86
             15521712617204216            سیمان فارس و خوزستان   337500000     6.00
             70289374539527245          قطعات‌ اتومبیل‌ ایران‌   259990000     4.19
             43622578471330344               گروه دارویی سبحان   183381668     5.65
             3863538898378476              سرمایه‌گذاری‌ مسکن‌   182160000     3.31
             25514780181345713   سرمایه‌ گذاری‌ ساختمان‌ایران‌   157816359    14.47
             15282093177363578      مهندسی و ساختمان صنایع نفت   129290612     5.13
             35669480110084448                   سیمان‌سپاهان‌   126674401     5.17
             12387472624849835                 داروسازی‌ اسوه‌   118276522    15.77
             57944184894703821    سرمایه‌ گذاری‌ البرز(هلدینگ‌   114588426     2.38
             7711282667602555                   پتروشیمی شازند   101805550     1.26
             60095061789823130  نهادهای مالی بورس اوراق بهادار    87997324     5.60
             6757220448540984                     سیمان‌ شمال‌    67919940     5.26
             30829203706095076                   سیمان‌ تهران‌    53400000     3.05
             59607545337891226                   به پرداخت ملت    36391574     1.21
             52220424531578944                      سیمان‌غرب‌    32151333     6.43
             33931218652865616        سرمایه‌گذاری‌ صنعت‌ نفت‌    30949707     1.87
             39807886630843041          تولید برق عسلویه  مپنا    30270982     4.15
             29747059672582491                  سیمان‌هرمزگان‌    29288000     2.70
             26997316501080743                     سیمان‌ شرق‌    29000000     1.09
             41974758296041288                   سیمان خوزستان    24338461     1.73
             17939384202383793  شرکت سرمایه گذاری مسکن شمالغرب    18333333     1.52
             10919655792568926   نهادهای مالی بورس کالای ایران    18324997     1.88
             28253678449273505              کشتیرانی دریای خزر    15600000     1.44
             11432067920374603                  داروسازی‌ سینا    13930853     1.74
             11964419322927535                    سیمان‌شاهرود    12400000     1.53
             59598536122397373        صندوق س.سپهرخبرگان نفت-د     8310000     1.66
             8603978909726038        ص.س.جسورانه فناوری آرمانی       50000     8.33
             57585821705408565              ص.ج.فیروزه10%تادیه       30000     6.00)
            >>> # getting intraday data
            >>> inst.get_intraday(
                date=20210704,
                general=False,
                thresholds=False,
                closings=False,
                candles=False,
                states=True,
                trades=True,
                holders=False,
                yesterday_holders=False,
                client_types=True,
                best_limits=True,
            )  # the result is too long and not shown here
            >>> # getting the history of price adjustments
            >>> inst.get_adjustments()  # the result is a DataFrame
                          تاریخ  تعدیل شده  قبل از تعدیل
            0   1399-05-01 00:00:00      35720         35970
            1   1398-04-26 00:00:00       4269          4419
            2   1397-10-02 00:00:00       2880          3744
            3   1397-04-20 00:00:00       3121          3271
            4   1396-08-08 00:00:00       1977          2173
            5   1396-05-01 00:00:00       1534          1884
            6   1395-04-29 00:00:00       1344          1397
            7   1395-04-22 00:00:00       1397          1597
            8   1394-06-30 00:00:00       1298          1378
            9   1393-09-11 00:00:00       2321          2639
            10  1393-04-24 00:00:00       2377          2777
            11  1392-03-20 00:00:00       2872          4774
            12  1392-03-19 00:00:00       4774          5794
            13  1391-04-06 00:00:00       3959          4659
            14  1390-04-14 00:00:00       4911         12991
            15  1390-04-14 00:00:00      12991         15241
            16  1389-04-12 00:00:00       6494          7694
            17  1388-04-24 00:00:00       4827          5627
            >>> # try Instrument.search if Instrument.from_l18 fails (may happen if the symbol is new and the database is not up-to-date)
            >>> Instrument.from_search('لطیف')
            Instrument(16422980660132735)
        
        
        The following functions can be used to fetch all the data available for creating `filters on tsetmc.com`_:
        
        * ``get_market_watch_init``
        * ``get_closing_price_all``
        * ``get_client_type_all``
        * ``get_key_stats``
        
        
        .. _pandas: https://pandas.pydata.org/
        .. _filters on tsetmc.com: http://www.tsetmc.com/Loader.aspx?ParTree=15131F
        
Keywords: tsetmc client
Platform: UNKNOWN
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
