CEDApy/README.md

93 lines
3.3 KiB
Markdown

# Centralized Economic Data API
![py_version](https://img.shields.io/badge/python-3.6+-brightgreen)
[![PyPI Version](https://img.shields.io/pypi/v/CEDApy.svg)](https://pypi.org/project/CEDApy)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.6459976.svg)](https://zenodo.org/record/6459976)
## Introduction
* "Centralized" means all-in-one, "all data" you need in one library
* "Economic data" means economic data :)
### Economic Data
We have included multiple API for banks or statistics deparment of countries/region:
* North America:
- [x] `FredData` for [Fred Reserve Bank](https://fred.stlouisfed.org/)
* Europe:
- [x] `ECBData` for [European Central Bank](https://www.ecb.europa.eu/home/html/index.en.html)
- [x] `EurostatData` for [European Statistics](https://ec.europa.eu/eurostat)
* Asia:
- [x] `NBSCData` for [National Bureau of Statistics of China](http://www.stats.gov.cn/english/)
- [x] `XHData` for [Xinhua](https://www.cnfin.com/data/macro-data/index.html)
- [x] `BOJData` for [Bank of Japan](https://www.boj.or.jp/en/index.htm/)
### Market Data
We have two api for approaching the market data:
- [x] `marketwatch` for [MarketWatch](https://www.marketwatch.com/)
- [x] `dukascopy` for [Dukascopy Historial Data](https://www.dukascopy.com/swiss/english/marketwatch/historical/)
*Recommandation is welcome! Tell us what data you need and we may put it into the to-do list :)*
### Other
We also collect some interesting data which may useful in your reserach or project
- [x] `EPU` for [Economic Policy Uncertainty](https://www.policyuncertainty.com/) and [Economic Policy Uncertainty in China](https://economicpolicyuncertaintyinchina.weebly.com/)
## Installation
Via the source code
```shell
git clone https://github.com/TerenceLiu98/CEDApy.git
python setup.py install
```
Via the `pypi`:
```shell
python -m pip install CEDApy
```
## How to use
Please check [Wiki](https://github.com/TerenceLiu98/CEDApy/wiki)
## Acknowledgement
* [St.Louis Federal Reserve Bank](https://fred.stlouisfed.org/), [Chicago Federal Reserve Bank](https://www.chicagofed.org/), [Philadelphia Federal Reserve Bank](https://www.philadelphiafed.org/)
* [eurostat Economic Indicators](https://ec.europa.eu/eurostat/cache/infographs/economy/desktop/index.html)
* [Europen Central Bank](https://www.ecb.europa.eu)
* [National bureau of Statistics China](http://www.stats.gov.cn/english/)
* [Bank of Japan](https://www.boj.or.jp/en/index.htm/)
* [MarketWatch](https://www.marketwatch.com/)
* [Dukascopy](https://www.dukascopy.bank/swiss)
## Other Interesting Project
Here is a list for some related packages or tools that may help you finding the data you want:
* [akshare](https://github.com/jindaxiang/akshare/) - an elegant and simple financial data interface library for Python, built for human beings
* [tushare](https://github.com/waditu/tushare) - a utility for crawling historial data of China stocks
* [investpy](https://github.com/alvarobartt/investpy) - Financial Data Extraction from Investing.com with Python
## If you want to cite...
```txt
@software{terencelau_2022_6459976,
author = {TerenceLau},
title = {TerenceLiu98/CEDApy: V0.3.6},
month = apr,
year = 2022,
publisher = {Zenodo},
version = {v0.3.6},
doi = {10.5281/zenodo.6459976},
url = {https://doi.org/10.5281/zenodo.6459976}
}
```