معرفی شرکت ها
financialdatapy-1.2.2
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Extract financial data of a company.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | financialdatapy-1.2.2 |
| نام | financialdatapy |
| نسخه کتابخانه | 1.2.2 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Choi Jiwoo |
| ایمیل نویسنده | cho2.jiwoo@gmail.com |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/financialdatapy/ |
| مجوز | MIT |
# financialdatapy
`financialdatapy` is a package for getting a fundamental financial data of a company. Currently it supports financial
data of companies listed in United States (NASDAQ, NYSE) and South Korea (KOSPI, KOSDAQ).
User can see the company's latest financial statement reported, standard financials, and historical stock
price. `financialdatapy` will be a good choice for research purposes, and managing an investment portfolio.
## Installation
To use `financialdatapy`, first install it using pip:
❗Python version above [3.10](https://www.python.org/downloads/release/python-3100/) is required to use `financialdatapy`
.
```commandline
pip install financialdatapy
```
## Quick Start
`financialdatapy` supports three major financial statements of a company. Income statement, balance sheet, and cash
flow. Also the user can select between annual and quarter financial statements.
### API Key
❗When getting financial statements of a company listed in Korea stock exchange, API Key
from [DART](https://opendart.fss.or.kr/) should be provided in the system to successfully retrieve its data.
After receiving API key, store it on a `.env` file in the root directory of your project.
Inside `.env` file.
```
DART_API_KEY=xxxxxxxxxxxxxxxx
```
### Initialization
```python
from financialdatapy.stock import Stock
# Apple
us_comp = Stock('aapl')
# Samsung Electronics
kor_comp = Stock('005930', country_code='kor') # should specify 'country_code' for stock exchange other than US
```
Values passed for financial statements and periods should follow the format below. If no argument is passed, it
automatically retrieves income statement from annual report.
```python
income_statement = us_comp.financials('income_statement')
balance_sheet = us_comp.financials('balance_sheet')
cash_flow = us_comp.financials('cash_flow')
# Annual Report
income_statement = kor_comp.financials('income_statement', 'annual')
# Quarterly Report
income_statement = kor_comp.financials('income_statement', 'quarter')
```
### Financial Statement as reported
Financial statements reported by the company to a financial regulator. The elements in the financial statements are
different from others, depending on the comapany and stock exchange.
**United States Stock Exchange**
```python
us_comp = Stock('aapl')
ic_as_reported = us_comp.financials('income_statement', 'annual')
```
**Korea Stock Exchange**
```python
kor_comp = Stock('005930', country_code='kor')
ic_as_reported = kor_comp.financials('income_statement', 'annual')
```
To see the full financial report from a browser, pass `True` in `web`. Supports both US exchange and KOR exchange.
```python
us_comp.financials(web=True)
kor_comp.financials(web=True)
```
### Standard Financial Statement
Summarized financial statements of a company.
```python
us_comp = Stock('msft')
std_ic = us_comp.financials('income_statement', 'annual', is_standard=True)
```
### Historical Stock Data
Historical stock price of the company.
```python
us_comp = Stock('aapl')
price = us_comp.price('2021-1-1', '2021-1-5')
```
All of the above will return in `pandas.DataFrame`.
❗️**Note**
Data source of stock price data differ from US stock exchange to KOR stock exchange.
| Exchange | Source |
| :------: | ----------------------------------------------- |
| USA | [finance.yahoo.com](https://finance.yahoo.com/) |
| KOR | [investing.com](https://www.investing.com/) |
### List of Companies in Stock Exchange
**United States Stock Exchange**
```python
from financialdatapy.stocklist import UsStockList
us_stock_list = UsStockList()
us_stock_list = us_stock_list.stock_list
```
**Korea Stock Exchange**
Api key is required to get the stock list of companies in Korea stock exchange. See more about the api key in the **_API
Key_** section above.
```python
from financialdatapy.stocklist import KorStockList
kor_stock_list = KorStockList()
kor_stock_list = kor_stock_list.stock_list
```
## Contribute
It will be a great help if you contribute to the package. You can open
issues [here](https://github.com/cho2ji/financialdatapy/issues)
### Code style
The project basically follows [PEP-8](https://www.python.org/dev/peps/pep-0008/>)
, [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html).
### Git commit messages
[](https://conventionalcommits.org)
The project basically follows Conventional Commits. Click on the badge to see the details.
```
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
```
## Documentation
See the full documentation [here](https://financialdatapy.readthedocs.io/en/latest/).
The documentation is built with [Sphinx](https://www.sphinx-doc.org/en/master/index.html) and deployed
with [Read the Docs](https://readthedocs.org/).
## License
Licensed under the MIT License
## Credits
Data used in the package are from [SEC EDGAR](https://www.sec.gov/os/accessing-edgar-data)
, [finance.yahoo.com](https://finance.yahoo.com/), [investing.com](https://www.investing.com/).
## Disclaimer
`financialdatapy` is not meant to be used in any kind of trading. The data might not be accurate, and timely.
`financialdatapy` is aimed for people who use stock data in their portfolio management and researchers who need stock
market data in their research. So if you are willing to use data for trading, there are lot more better options.
نیازمندی
| مقدار | نام |
|---|---|
| >=1.4.0 | pandas |
| >=2.27.1 | requests |
| >=0.12.0 | xmltodict |
| >=0.19.2 | python-dotenv |
| >=4.10.0 | beautifulsoup4 |
| >=4.7.1 | lxml |
| >=0.1.10 | user-agent |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.10 | Python |
نحوه نصب
نصب پکیج whl financialdatapy-1.2.2:
pip install financialdatapy-1.2.2.whl
نصب پکیج tar.gz financialdatapy-1.2.2:
pip install financialdatapy-1.2.2.tar.gz