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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file finra_api_queries-1.2.1.tar.gz.

File metadata

  • Download URL: finra_api_queries-1.2.1.tar.gz
  • Upload date:
  • Size: 11.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.0 CPython/3.9.4 Windows/10

File hashes

Hashes for finra_api_queries-1.2.1.tar.gz
Algorithm Hash digest
SHA256 60ad2da0d0628216822d11d858f507d9b8c5fe1d1846c26ab924718566c6c609
MD5 ee22fe4b86ee5d19628dc349571f84c5
BLAKE2b-256 2836dc2c3fce80eaf5a6464e467faa23ef033bdfda97e06437c20d346742200e

See more details on using hashes here.

File details

Details for the file finra_api_queries-1.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for finra_api_queries-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 90b9d2fc67b0a6fcd6f92d2838dc77f317b203e5874002198b6edb5eb9f3a11c
MD5 c1686a5feb5942c6fb607f5a8a653e9a
BLAKE2b-256 e8c01f2a9a1617f196479e20a90d1767e9630dbd71c2f204027677ddefe0d1af

See more details on using hashes here.

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