7/19/2020 GitHub - Glyphack/pytse-client: work with Tehran stock exchange data in Python

Glyphack / pytse-client

work with Tehran stock exchange data in Python

51 stars 10 forks

Star Watch

Code Issues 3 Pull requests Actions Projects 1 Wiki Securit

Dismiss
Join GitHub today
GitHub is home to over 50 million developers
working together to host and review code, manage
projects, and build software together.

Sign up

master

Glyphack committed 5 days ago 85 commits

View code

README.md

‫در ﯾﺎﻓﺖ اﻃ ﻋﺎت ﺑﺎزار ﺑﻮرس ﺗﻬﺮان‬

‫ ﻫﺪف ﺣﻞ‬.‫داﺷﺘﻪ ﺑﺎﺷﯿﺪ‬ ‫ ﻣﯿﺘﻮﻧﯿﺪ ﺑﻪ دﯾﺘﺎی ﺑﺎزار ﺑﻮرس ﺗﻬﺮان در ﭘﺎﯾﺘﻮن دﺳﺘﺮ‬pytse client ‫ﺑﺎ اﺳﺘﻔﺎده از‬
.‫ﻣﺸﮑ ت ﮔﺮﻓﺘﻦ اﻃ ﻋﺎت ﺑﺮوز از ﺳﺎﯾﺖ ﺑﺎزار ﺑﻮرس ﺗﻬﺮان ﻫﺴﺖ‬

‫ﻣﺤﺘﻮﯾﺎت‬
‫ﻗﺎﺑﻠﯿﺖ ﻫﺎ‬
‫ﻧﺼﺐ‬

https://github.com/Glyphack/pytse-client 1/5
‫‪7/19/2020‬‬ ‫‪GitHub - Glyphack/pytse-client: work with Tehran stock exchange data in Python‬‬

‫ﻧﺤﻮه اﺳﺘﻔﺎده‬
‫داﻧﻠﻮد ﺳﺎﺑﻘﻪ ﺳﻬﻢﻫﺎ‬
‫ﻣﺎژول ‪Ticker‬‬
‫اﻃ ﻋﺎت ﺣﻘﯿﻘﯽ و ﺣﻘﻮﻗﯽ‬
‫ﭘﮑﯿﺞ ﻫﺎی ﻣﻮرد ﻧﯿﺎز‬
‫اﻟﻬﺎم ﮔﺮﻓﺘﻪ از‬

‫ﻗﺎﺑﻠﯿﺖ ﻫﺎ‬
‫درﯾﺎﻓﺖ اﻃ ﻋﺎت روز ﻫﺎی ﻣﻌﺎﻣ ﺗﯽ ﻫﺮ ﺳﻬﻢ و ﻗﺎﺑﻠﯿﺖ ذﺧﯿﺮه ﺳﺎزی‬
‫ﻗﺎﺑﻠﯿﺖ ﮔﺮﻓﺘﻦ اﻃ ﻋﺎت ﯾﮏ ﺳﻬﺎم ﻣﺎﻧﻨﺪ ﮔﺮوه ﺳﻬﺎم و اﻃ ﻋﺎت ﻣﻌﺎﻣ ت ﺣﻘﯿﻘﯽ و ﺣﻘﻮﻗﯽ‬
‫درﯾﺎﻓﺖ اﻃ ﻋﺎت ﻓﺎﻧﺪاﻣﻨﺘﺎل ﯾﮏ ﻧﻤﺎد ﺷﺎﻣﻞ)‪, eps, p/e‬ﺣﺠﻢ ﻣﺒﻨﺎ(‬

‫ﻧﺼﺐ‬

‫‪pip install pytse-client‬‬

‫ﻧﺤﻮه اﺳﺘﻔﺎده‬

‫داﻧﻠﻮد ﺳﺎﺑﻘﻪ ﺳﻬﻢﻫﺎ‬

‫ﺑﺎ اﺳﺘﻔﺎده از اﯾﻦ ﺗﺎﺑﻊ ﻣﯿﺘﻮان ﺳﺎﺑﻘﻪ ﺳﻬﺎم ﻫﺎرو درﯾﺎﻓﺖ ﮐﺮد و ﻫﻢ اون رو ذﺧﯿﺮه و ﻫﻢ ﺗﻮی ﮐﺪ اﺳﺘﻔﺎده‬
‫ﮐﺮد‬

‫‪import pytse_client as tse‬‬

‫)‪tickers = tse.download(symbols="all", write_to_csv=True‬‬
‫‪"] # history‬وﻟﻤﻠﺖ"[‪tickers‬‬

‫‪date‬‬ ‫‪open‬‬ ‫‪high‬‬ ‫‪...‬‬ ‫‪volume‬‬ ‫‪count‬‬ ‫‪close‬‬

‫‪0‬‬ ‫‪2009-02-18‬‬ ‫‪1050.0‬‬ ‫‪1050.0‬‬ ‫‪...‬‬ ‫‪330851245‬‬ ‫‪800‬‬ ‫‪1050.0‬‬
‫‪1‬‬ ‫‪2009-02-21‬‬ ‫‪1051.0‬‬ ‫‪1076.0‬‬ ‫‪...‬‬ ‫‪335334212‬‬ ‫‪6457‬‬ ‫‪1057.0‬‬
‫‪2‬‬ ‫‪2009-02-22‬‬ ‫‪1065.0‬‬ ‫‪1074.0‬‬ ‫‪...‬‬ ‫‪8435464‬‬ ‫‪603‬‬ ‫‪1055.0‬‬
‫‪3‬‬ ‫‪2009-02-23‬‬ ‫‪1066.0‬‬ ‫‪1067.0‬‬ ‫‪...‬‬ ‫‪8570222‬‬ ‫‪937‬‬ ‫‪1060.0‬‬
‫‪4‬‬ ‫‪2009-02-25‬‬ ‫‪1061.0‬‬ ‫‪1064.0‬‬ ‫‪...‬‬ ‫‪7434309‬‬ ‫‪616‬‬ ‫‪1060.0‬‬
‫‪...‬‬ ‫‪...‬‬ ‫‪...‬‬ ‫‪...‬‬ ‫‪...‬‬ ‫‪...‬‬ ‫‪...‬‬ ‫‪...‬‬
‫‪2323‬‬ ‫‪2020-04-14‬‬ ‫‪9322.0‬‬ ‫‪9551.0‬‬ ‫‪...‬‬ ‫‪105551315‬‬ ‫‪13536‬‬ ‫‪9400.0‬‬
‫‪2324‬‬ ‫‪2020-04-15‬‬ ‫‪9410.0‬‬ ‫‪9815.0‬‬ ‫‪...‬‬ ‫‪201457026‬‬ ‫‪11322‬‬ ‫‪9815.0‬‬
‫‪2325‬‬ ‫‪2020-04-18‬‬ ‫‪10283.0‬‬ ‫‪10283.0‬‬ ‫‪...‬‬ ‫‪142377245‬‬ ‫‪8929‬‬ ‫‪10283.0‬‬
‫‪2326‬‬ ‫‪2020-04-19‬‬ ‫‪10797.0‬‬ ‫‪10797.0‬‬ ‫‪...‬‬ ‫‪292985635‬‬ ‫‪22208‬‬ ‫‪10380.0‬‬
‫‪2327‬‬ ‫‪2020-04-20‬‬ ‫‪10600.0‬‬ ‫‪11268.0‬‬ ‫‪...‬‬ ‫‪295590437‬‬ ‫‪16313‬‬ ‫‪11268.0‬‬

‫‪https://github.com/Glyphack/pytse-client‬‬ ‫‪2/5‬‬
7/19/2020 GitHub - Glyphack/pytse-client: work with Tehran stock exchange data in Python

:‫ﺑﺮای داﻧﻠﻮد ﺳﺎﺑﻘﻪ ﯾﮏ ﯾﺎ ﭼﻨﺪ ﺳﻬﻢ ﮐﺎﻓﯽ ﻫﺴﺖ اﺳﻢ اون ﻫﺎ ﺑﻪ ﺗﺎﺑﻊ داده ﺑﺸﻪ‬

‫ ﺳﺎﺑﻘﻪ ﺳﻬﻢ ﺗﻮی ﻓﺎﯾﻠﯽ ﺑﺎ اﺳﻢ ﺳﻬﻢ ﻧﻮﺷﺘﻪ ﻣﯿﺸﻪ‬write_to_csv=True ‫ﻫﻤﭽﻨﯿﻦ ﺑﺎ ﮔﺬاﺷﺘﻦ‬

‫ اﺳﺖ‬Dataframe ‫ﺳﺎﺑﻘﻪ ﺳﻬﻢ در ﻗﺎﻟﺐ‬

‫ﺑﻪ ﺧﺮوﺟﯽ اﺿﺎﻓﻪ ﺷﻮد ﻣﯽ ﺗﻮاﻧﯿﺪ ﺑﺎ ﮔﺬاﺷﺘﻦ‬ ‫درﺻﻮرﺗﯽ ﮐﻪ ﻣﯽ ﺧﻮاﻫﯿﺪ ﺗﺎرﯾﺦ ﺷﻤ‬
‫ اﯾﻦ اﻣﮑﺎن را ﻓﺮاﻫﻢ ﮐﻨﯿﺪ‬include_jdate=True

import pytse_client as tse

tse.download(symbols="‫"وﺑﻤﻠﺖ‬, write_to_csv=True)
tse.download(symbols="‫"وﺑﻤﻠﺖ‬, write_to_csv=True, include_jdate=True)
tse.download(symbols=["‫ "وﻟﻤﻠﺖ‬,"‫]"وﺑﻤﻠﺖ‬, write_to_csv=True)

Ticker ‫ﻣﺎژول‬
‫اﯾﻦ ﻣﺎژول ﺑﺮای ﮐﺎر ﺑﺎ دﯾﺘﺎی ﯾﮏ ﺳﻬﻢ ﺧﺎص ﻫﺴﺖ و ﺑﺎ ﮔﺮﻓﺘﻦ ﻧﻤﺎد اﻃ ﻋﺎت ﻣﻮﺟﻮد رو ﻣﯿﺪه‬

:‫ﺑﺮای ﻣﺜﺎل‬

import pytse_client as tse

tse.download(symbols="‫"وﺑﻤﻠﺖ‬, write_to_csv=True) # optional

ticker = tse.Ticker("‫)"وﺑﻤﻠﺖ‬
print(ticker.history) # ‫ﺳﺎﺑﻘﮫ ﻗﯿﻤﺖ ﺳﮭﻢ‬
print(ticker.client_types) # ‫ﺣﻘﯿﻘﯽ ﺣﻘﻮﻗﯽ‬
print(ticker.title) # ‫ﻧﺎم ﺷﺮﮐﺖ‬
‫)ﺑﺎﻧﻚ ﻣﻠﺖ )وﺑﻤﻠﺖ‬
print(ticker.url) # ‫آدرس ﺻﻔﺤﮫ ﺳﮭﻢ‬
http://tsetmc.com/Loader.aspx?ParTree=151311&i=778253364357513
print(ticker.group_name) # ‫ﻧﺎم ﮔﺮوه‬
‫ﺑﺎﻧﻜﮭﺎ و ﻣﻮﺳﺴﺎت اﻋﺘﺒﺎري‬
print(ticker.eps) # eps
2725.0
print(ticker.p_e_ratio) # P/E
6.1478899082568805
print(ticker.group_p_e_ratio) # group P/E
18.0
print(ticker.base_volume) # ‫ﺣﺠﻢ ﻣﺒﻨﺎ‬
7322431.0
print(ticker.last_price) # ‫آﺧﺮﯾﻦ ﻣﻌﺎﻣﻠﮫ‬
17316
print(ticker.adj_close) # ‫ﻗﯿﻤﺖ ﭘﺎﯾﺎﻧﯽ‬
16753
print(ticker.best_supply_price) # ‫ﻗﯿﻤﺖ ﺑﮭﺘﺮﯾﻦ ﺗﻘﺎﺿﺎ‬
26700
print(ticker.best_supply_vol) # ‫ﺣﺠﻢ ﺑﮭﺘﺮﯾﻦ ﺗﻘﺎﺿﺎ‬

https://github.com/Glyphack/pytse-client 3/5
‫‪7/19/2020‬‬ ‫‪GitHub - Glyphack/pytse-client: work with Tehran stock exchange data in Python‬‬

‫‪357062‬‬
‫ﻗﯿﻤﺖ ﺑﮭﺘﺮﯾﻦ ﻋﺮﺿﮫ ‪print(ticker.best_demand_price) #‬‬
‫‪26700‬‬
‫ﺣﺠﻢ ﺑﮭﺘﺮﯾﻦ ﻋﺮﺿﮫ ‪print(ticker.best_demand_vol) #‬‬
‫‪576608‬‬

‫ﺑﺮای اﺳﺘﻔﺎده زم ﻧﯿﺴﺖ ﺣﺘﻤﺎ ﺗﺎﺑﻊ داﻧﻠﻮد ﺻﺪا زده ﺑﺸﻪ‪ .‬اﮔﺮ اﯾﻦ ﮐﺪ رو ﺑﺪون داﻧﻠﻮد ﮐﺮدن ﺳﻬﻢ اﺳﺘﻔﺎده‬
‫ﮐﻨﯿﺪ ﺧﻮدش اﻃ ﻋﺎت ﺳﻬﻢ رو از ﺳﺎﯾﺖ ﻣﯿﮕﯿﺮه‪ ،‬اﻣﺎ اﮔﺮ ﻗﺒﻞ از اون از داﻧﻠﻮد اﺳﺘﻔﺎده ﮐﺮده ﺑﺎﺷﯿﺪ ﺑﻪ ﺟﺎی‬
‫ﯾﻊ ﺗﺮ ﻫﺴﺖ‬ ‫ﮔﺮﻓﺘﻦ از اﯾﻨﺘﺮﻧﺖ اﻃ ﻋﺎت رو از روی ﻓﺎﯾﻞ ﻣﯿﺨﻮﻧﻪ ﮐﻪ‬

‫ﻧﮑﺘﻪ‬

‫ﻃﺒﻖ ﺗﺠﺮﺑﻪ ای ﮐﻪ داﺷﺘﻢ ﭼﻮن ﮔﺎﻫﯽ اوﻗﺎت ﺳﺎﯾﺖ ﺑﻮرس ﻣﺪت زﯾﺎدی ﻃﻮل ﻣﯿﮑﺸﻪ ﺗﺎ اﻃ ﻋﺎت رو‬
‫ﻣﻮاﻗﻊ ﻧﻤﯿﻔﺮﺳﺘﻪ ﺑﻬﺘﺮ ﻫﺴﺖ ﮐﻪ اول ﺗﺎﺑﻊ داﻧﻠﻮد رو اﺳﺘﻔﺎده ﮐﻨﯿﺪ ﺑﺮای ﺳﻬﻢﻫﺎﯾﯽ ﮐﻪ‬ ‫ﺑﻔﺮﺳﺘﻪ ﯾﺎ ﺑﻌ‬
‫زم ﻫﺴﺖ و ﺑﻌﺪ ﺑﺎ دﯾﺘﺎی اون ﻫﺎ ﮐﺎر ﮐﻨﯿﺪ‪.‬‬

‫اﻃ ﻋﺎت ﺣﻘﯿﻘﯽ و ﺣﻘﻮﻗﯽ‬

‫اﻃ ﻋﺎت ﺧﺮﯾﺪ و ﻓﺮوش ﺣﻘﯿﻘﯽ و ﺣﻘﻮﻗﯽ ﺳﻬﺎم رو ﻣﯿﺸﻪ از ﻃﺮﯾﻖ ‪ ticker.client_types‬ﮔﺮﻓﺖ اﯾﻦ‬
‫ﮐﻪ در اﯾﻦ ﺻﻔﺤﻪ‬ ‫اﻃ ﻋﺎت ﯾﻪ ‪ DataFrame‬ﺷﺎﻣﻞ اﻃ ﻋﺎت ﻣﻮﺟﻮد در ﺗﺐ ﺣﻘﯿﻘﯽ ﺣﻘﻮﻗﯽ)ﺗﺐ ﺑﻨﻔ‬
‫ﻫﺴﺖ( ﺳﻬﻢ ﻫﺴﺖ‪:‬‬

‫ﺗﺎرﯾﺦ ‪date :‬‬

‫ﺗﻌﺪاد ﻣﻌﺎﻣﻼت ﺧﺮﯾﺪ ﺣﻘﯿﻘﯽ ‪individual_buy_count :‬‬
‫ﺗﻌﺪاد ﻣﻌﻼﻣﻼت ﺧﺮﯾﺪ ﺣﻘﻮﻗﯽ ‪corporate_buy_count :‬‬
‫ﺗﻌﺪاد ﻣﻌﺎﻣﻼت ﻓﺮوش ﺣﻘﯿﻘﯽ ‪individual_sell_count :‬‬
‫ﺗﻌﺪاد ﻣﻌﻼﻣﻼت ﻓﺮوش ﺣﻘﻮﻗﯽ ‪corporate_sell_count :‬‬
‫ﺣﺠﻢ ﺧﺮﯾﺪ ﺣﻘﯿﻘﯽ ‪individual_buy_vol :‬‬
‫ﺣﺠﻢ ﺧﺮﯾﺪ ﺣﻘﻮﻗﯽ ‪corporate_buy_vol :‬‬
‫ﺣﺠﻢ ﻓﺮوش ﺣﻘﯿﻘﯽ ‪individual_sell_vol :‬‬
‫ﺣﺠﻢ ﻓﺮوش ﺣﻘﻮﻗﯽ ‪corporate_sell_value :‬‬
‫ﻗﯿﻤﺖ ﻣﯿﺎﻧﮕﯿﻦ ﺧﺮﯾﺪ ﺣﻘﯿﻘﯽ ‪individual_buy_mean_price :‬‬
‫ﻗﯿﻤﺖ ﻣﯿﺎﻧﮕﯿﻦ ﻓﺮوش ﺣﻘﯿﻘﯽ ‪individual_sell_mean_price :‬‬
‫ﻗﯿﻤﺖ ﻣﯿﺎﻧﮕﯿﻦ ﺧﺮﯾﺪ ﺣﻘﻮﻗﯽ ‪corporate_buy_mean_price :‬‬
‫ﻗﯿﻤﺖ ﻣﯿﺎﻧﮕﯿﻦ ﻓﺮوش ﺣﻘﻮﻗﯽ ‪corporate_sell_mean_price :‬‬
‫ﺗﻐﯿﯿﺮ ﻣﺎﻟﮑﯿﺖ ﺣﻘﻮﻗﯽ ﺑﮫ ﺣﻘﯿﻘﯽ ‪individual_ownership_change :‬‬

‫ﮐﺎﻣﯿﻮﻧﯿﺘﯽ‬

‫ور دﯾﺴﮑﻮرد ﺑﭙﺮﺳﯿﺪ‪.‬‬ ‫اﮔﺮ درﺑﺎره ﭘﮑﯿﺞ ﯾﺎ اﺳﺘﻔﺎده از اون ﺳﻮاﻟﯽ دارﯾﺪ ﻣﯿﺘﻮﻧﯿﺪ ﺗﻮی‬

‫‪https://discord.gg/D3txK6‬‬

‫ﭘﮑﯿﺞ ﻫﺎی ﻣﻮرد ﻧﯿﺎز‪:‬‬

‫‪https://github.com/Glyphack/pytse-client‬‬ ‫‪4/5‬‬
7/19/2020 GitHub - Glyphack/pytse-client: work with Tehran stock exchange data in Python

Pandas
Requests
jdatetime

:‫اﻟﻬﺎم ﮔﺮﻓﺘﻪ از‬

tehran_stocks
yfinance

Releases 3

‫ﺑﻬﺒﻮد ﻣﺘﻮد داﻧﻠﻮد اﻃ ﻋﺎت ﻣﻌﺎﻣ ت‬ Latest

6 days ago

+ 2 releases

Contributors 4

Glyphack Glyphack

farhadmpr farhadmpr

hhdri hhdri

Frostack Frostack

Languages

Python 100.0%

https://github.com/Glyphack/pytse-client 5/5