Skip to main content

FedTools

Downloads Downloads

An open source Python library for the scraping of Federal Reserve data.

By default, all modules within FedTools use 10 threads to increase scraping speed. By default, the Output is a Pandas DataFrame, indexed by release date of the materials. Additional serialised storage methods are optional.

Installation

pip install Fedtools

Import the classes:

from FedTools import MonetaryPolicyCommittee
from FedTools import BeigeBooks
from FedTools import FederalReserveMins

Usage

Returns a Pandas DataFrame dataset, which contains all Meeting Minutes, indexed by Date:

from FedTools import MonetaryPolicyCommittee

dataset = MonetaryPolicyCommittee().find_statements()
MonetaryPolicyCommittee().pickle_data("directory.pkl")

Returns a Pandas DataFrame dataset, which contains all Beige Books, indexed by Date:

from FedTools import BeigeBooks

dataset = BeigeBooks().find_beige_books()
BeigeBooks().pickle_data("directory.pkl")

Returns a Pandas DataFrame dataset, which contains all Federal Reserve Minutes since 1993, indexed by Date:

from FedTools import FederalReserveMins

dataset = FederalReserveMins().find_minutes()
FederalReserveMins().pickle_data("directory.pkl")

Edit Default Input Arguments

###Monetary Policy Committee

To modify the MonetaryPolicyCommittee default parameters, each of the below can be adjusted:

monetary_policy = MonetaryPolicyCommittee(
            main_url = 'https://www.federalreserve.gov', 
            calendar_url = 'https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm',
            start_year = 1994,    
            historical_split = 2014,
            verbose = True,
            thread_num = 10)
            
dataset = monetary_policy.find_statements()

BeigeBooks

To modify the BeigeBooks default parameters, each of the below can be adjusted:

beige_books = BeigeBooks(
            main_url = 'https://www.federalreserve.gov', 
            beige_book_url='https://www.federalreserve.gov/monetarypolicy/beige-book-default.htm',
            start_year = 1996,        
            historical_split = 2019,
            verbose = True,
            thread_num = 10)
                 
dataset = beige_books.find_beige_books()

FederalReserveMins

To modify the FederalReserveMins default parameters, each of the below can be adjusted:

fed_mins = FederalReserveMins(
            main_url = 'https://www.federalreserve.gov', 
            calendar_url ='https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm',
            start_year = 1995,        
            historical_split = 2014,
            verbose = True,
            thread_num = 10)

dataset = fed_mins.find_minutes()

Parameter Explanation

All parameters within the package have default values which can be overriden, with a short explanation of each parameter outlined below:

Argument Description
main_url Federal Reserve Open Monetary Policy (FOMC) website URL. (str)
calendar_url URL containing a list of FOMC Meeting dates and Minutes release dates. (str)
beige_book_url URL containing a list of Beige Book release dates. (str)
start_year first year from which to begin collecting data. (int)
historical_split first year considered as historical (Check Here for FOMC and Minutes or Check Here for Beige Books). (int)
verbose boolean determining printing during scraping. (bool)
thread_num the number of threads to use for web scraping. (int)

Metadata

Release files for Fedtools 0.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Fedtools 0.0.7
File Size Uploaded
Fedtools-0.0.7.tar.gz 6.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Fedtools 0.0.7
File Interpreter ABI Platform
Fedtools-0.0.7-py3-none-any.whl Python 3 none any Details

Total release size: 20.2 kB

Release files / Fedtools-0.0.7.tar.gz

Download URL Fedtools-0.0.7.tar.gz
Size 6.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8df92e1629795075f2b665e44e05ff2eec00d19e16cd01c66e8e0cad42b9ed43
BLAKE2b-256 checksum
How to use checksums
3b25dec08164bb5d4e4323793b7af519b51a003d624a6a8e8636051330f6ab25
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.13

Release files / Fedtools-0.0.7-py3-none-any.whl

Download URL Fedtools-0.0.7-py3-none-any.whl
Size 13.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c78475e0cfa0272bd0bef269505dece75c6dc1a82dc56c395c1658dc8b9103fe
BLAKE2b-256 checksum
How to use checksums
90331ae370b3b16f5dda84412b3847e6f40f213d47641df2e5a28199fe0baa66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.13

Release history Release notifications | RSS feed

This release

0.0.7 This release

2 release files

0.0.6

1 release file

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page