Skip to main content

An API wrapper for FINRA's Query API

Project description

finra_api_queries

FINRA is the Financial Industry Regulatory Authority, which oversees US brokerages and exchanges such as the NYSE and NASDAQ. They ensure that brokers and dealers in US stock/debt markets are acting according to the laws and rules defined by the Securities and Exchange Commission (SEC) as well as by FINRA. Their API contains information about historical market activity, such as fixed income market activity, statistics such as the size of trades that major institutional investors make, and over-the-counter (OTC) trading activity. This information allows regulators as well as the public to understand market trading behavior.

The finra_api_queries package simplifies the querying of the FINRA Query API including more complex API calls. It also features functions that enable the time series data visualization of fixed income data, summarization of key market breadth data, and keyword filtering for stocks.

Installation

$ pip install finra_api_queries

How to Use

$ from finra_api_queries import finra_api_queries

Usage

  1. Obtain an API key and secret on the FINRA API website.
  2. Input the key and secret using the retrieve_api_token() function to generate the time-limited access token necessary to retrieve data from the API.
  3. Use the various functions to easily extract data sets from the FINRA Query API with a variety of parameters, visualize time series data, as well as filter and aggregate data in pandas data frames and Seaborn plots.
  4. Use API to glean time series-related and aggregated insights about fixed income activity and trading block activity.

This package features the following 7 functions:

  • retrieve_api_token
  • show_filterable_columns
  • retrieve_dataset
  • filter_market_participant
  • summarize_trading_breadth
  • visualize_market_sentiment
  • generate_market_participant_summary

readthedocs Package Documentation

https://finra-api-queries.readthedocs.io/en/latest/

Test PyPi Link

https://test.pypi.org/project/finra-api-queries/

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License

finra_api_queries was created by Cindy Chen. It is licensed under the terms of the MIT license.

Credits

finra_api_queries was created with cookiecutter and the py-pkgs-cookiecutter template.

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

finra_api_queries-1.2.1.tar.gz (11.3 kB view hashes)

Uploaded Source

Built Distribution

finra_api_queries-1.2.1-py3-none-any.whl (11.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page