Skip to main content

PyPI version Code style: black Code style: isort flake8 ruff

For full documentation, visit here

Stock Data Extractor (Stockdex)

Stockdex is a Python package that provides a simple interface to get financial data from various sources in pandas DataFrames and Plotly figures.


Advantages of Stockdex over similar packages

  • Various data sources: Stockdex provides data from Yahoo Finance and other sources like Digrin, Finviz, Macrotrends and JustETF (for EU ETFs).

  • Historical data: Stockdex provides a wide time range of data, e.g. Digrin and Macrotrends sources provide historical data in a span of years.

  • Numerous data categories: Stockdex provides financials criteria including financial statements, earnings, dividends, stock splits, list of key executives, major shareholders and more.

  • plotting capabilities (new feature): Stockdex provides plotting financial data using bar, line, and sankey plots. Multiple plots can be combined in dash app.


Installation

Install the package using pip:

pip install stockdex -U

do a simple test to verify the package is installed correctly:

from stockdex import Ticker

ticker = Ticker(ticker="NVDA")
result = ticker.yahoo_api_income_statement(frequency='quarterly')

Use with Claude

Stockdex ships a local, read-only MCP server so Claude can fetch prices, financial statements and dividends for you.

  • Claude Desktop: download stockdex.mcpb from the latest release and double-click it.

  • Claude Code: install the plugin, which requires uv:

    /plugin marketplace add ahnazary/stockdex
    /plugin install stockdex@stockdex
    
  • Other MCP clients: run uvx --from "stockdex[mcp]" stockdex-mcp.

See Use with Claude for arguments, limits and output format.

License

This project is licensed under the MIT License.

Contributing

Stockdex is an open-source project, and contributions of any kind are welcome and appreciated!
Whether you want to report a bug, suggest a new feature, improve documentation, or submit code — every contribution helps.

How to contribute

  • Issues
    Found a bug or have an idea for an improvement? Please open an issue on GitHub and describe it clearly.

  • Pull Requests (PRs)
    If you’d like to fix something directly, fork the repository and open a PR.
    Please include a short description of the change and reference any related issues.

Guidelines

There are no Guidelines as of now :)


❤️ Thank you in advance for your contribution! ❤️

Metadata

Release files for stockdex 1.3.0

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

Source distribution (sdist)

Source distribution for stockdex 1.3.0
File Size Uploaded Provenance Actions
stockdex-1.3.0.tar.gz 7.5 MB Without provenance Details for stockdex-1.3.0.tar.gz

Built distribution (wheel)

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

Total release size: 14.9 MB

Release files / stockdex-1.3.0.tar.gz

Download URL stockdex-1.3.0.tar.gz
Size 7.5 MB
Tags Source
SHA-256 checksum
How to use checksums
e54fb253ee0b64a9fadb8c0fdec7a120dcd896db593e5df35c102a1219244e1f
BLAKE2b-256 checksum
How to use checksums
c624671c9ba2253245617d21b73dbd45da9efe7fd28c032df974c4875afb5b20
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Release files / stockdex-1.3.0-py3-none-any.whl

Download URL stockdex-1.3.0-py3-none-any.whl
Size 7.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d804cc17446308b70c5cbf3fcd2e9be23a9fdbd934e25540470053aa53c3d5e7
BLAKE2b-256 checksum
How to use checksums
41ddf3ed89059a9c3e88c00eca6cfb3d26fc96abd6108e6f1a1686ac22100b37
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Security for stockdex 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files No provenance

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