Git Product home page Git Product logo

fipiran's Introduction

An async python library to fetch data from https://www.fipiran.com/ .

Note: This is package is incomplete and still in initial development phase. The API may change without deprecation.

Installation

Requires Python 3.12+.

$ pip install fipiran

Usage

import asyncio
from fipiran.symbols import Symbol

async def main():
    company_info = await Symbol('فملی').company_info()
    print(company_info)

asyncio.run(main())

There are four modules:

  • data_service
  • funds
  • symbols
  • codal

Use an asyncio-aware REPL, like python -m asyncio, to run the code samples below.

Example 1:

>>> from fipiran.symbols import Symbol
>>> await Symbol('فملی').company_info()
{'نام نماد': 'فملی',
 'نام شرکت': 'ملی صنایع مس ایران',
 'مدیر عامل': 'اردشیر سعدمحمدی',
 'تلفن': '021-88724410',
 'فکس': '021-88729014',
 'آدرس': 'مجتمع مس سرچشمه و مجتمع مس میدوک در استان کرمان و مجتمع مس سونگون در تبریز شهرستان ورزقان واقع شده اند.',
 'وب سایت': 'www.nicico.com',
 'ایمیل': '[email protected]',
 'سال مالی': '12/29',
 'موضوع فعالیت': 'اکتشافات،  استخراج و  بهره برداری از معادن  مس  ایران'}

Example 2:

Getting list of funds as a pandas DataFrame object.

>>> from fipiran.funds import funds
>>> await funds()
     regNo                                  name  ...      isCompleted  fundWatch
0    11726                        جسورانه فیروزه  ...         True       None
1    11603              جسورانه فناوری بازنشستگی  ...         True       None
2    11780                    گروه زعفران سحرخیز  ...         True       None
3    11772                      طلای سرخ نو ویرا  ...         True       None
4    11480                 جسورانه یکم آرمان آتی  ...         True       None
..     ...                                   ...  ...          ...        ...
308  11916                    با درآمد ثابت آریا  ...        False       None
309  11922                      آوای تاراز زاگرس  ...        False       None
310  11927                    صندوق در صندوق صنم  ...        False       None
311  11931  اختصاصی بازارگردانی توسعه سهام عدالت  ...        False       None
312  11933       اختصاصی بازارگردانی تثبیت پاداش  ...        False       None
[313 rows x 37 columns]

There are many other functions and methods. Please explore the code-base for more info.

If you are interested in other information that are available on fipiran.com but this library has no API for, please open an issue for them on github.

See also

fipiran's People

Contributors

5j9 avatar

Stargazers

Mohammad Masoudie avatar RezaHSoureh avatar AFP avatar morteza omidi avatar  avatar Amin Zargarzadeh avatar

Watchers

James Cloos avatar  avatar  avatar morteza omidi avatar

Forkers

morteza561

fipiran's Issues

Date in Fipiran

Hi, thanks for amazing library
In this library can we specify date to get data for specific time period?
Such as NAV for specific fund from 2020/1/1 to 2023/1/1.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.