Tehran Stock Exchange OSINT Tool for Python
Project description
This is just an Alpha release, So If you find it interesting or you encounter any bugs, I would appreciate if you let me know!
Overview
Currently there is no active well-documented API for TSE capital market out there. And this is a big obstacle to development of projects and studies based on this data. tfinance aimes to solve this problem by developing an OSINT tool to provide a reliable, threaded, and Pythonic way to access TSE’s historical data.
>> import tfinance as tfin
>> market = tfin.Market() # Initializes your local database - The first run on your system may take a few minutes(~It will download ~90MB of data.)
>> market.tickers.head()
id name ... sub_market ticker_code
0 37661500521100963 توليد نيروي برق آبادان ... فهرست اوليه IRO1NBAB0001
1 55254206302462116 آسان پرداخت پرشين ... فهرست اوليه IRO1APPE0001
2 51106317433079213 بيمه آسيا ... تابلو اصلي IRO1ASIA0001
3 14079693677610396 انتقال داده هاي آسياتك ... فهرست اوليه IRO1ASTC0001
4 44834847569322522 كنتورسازيايران ... تابلو فرعي IRO1CONT0001
>>foolad = tfin.Ticker(ticker="فولاد")
>> foolad.name
'فولاد مباركه اصفهان'
>> foolad.sector
'فلزات اساسي'
>> foolad.history.head()
<TICKER> <DTYYYYMMDD> <FIRST> ... <PER> <OPEN> <LAST>
0 S*Mobarakeh.Steel 2020-10-06 17700.0 ... D 17860.0 18240.0
1 S*Mobarakeh.Steel 2020-10-05 17610.0 ... D 18210.0 17700.0
2 S*Mobarakeh.Steel 2020-10-04 18760.0 ... D 18710.0 18090.0
3 S*Mobarakeh.Steel 2020-10-03 18290.0 ... D 17920.0 18810.0
4 S*Mobarakeh.Steel 2020-09-30 18170.0 ... D 17500.0 18290.0
[5 rows x 12 columns]
Installation
The easiest way to install tfinance is from the Python Package Index using pip or easy_install:
$ pip install tfinance
License
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tfinance-0.1.4.tar.gz
(21.2 kB
view hashes)
Built Distribution
tfinance-0.1.4-py3-none-any.whl
(22.0 kB
view hashes)