Skip to main content

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

Stockdex logo with three ascending candlesticks

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.1

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.1
File Size Uploaded Provenance Actions
stockdex-1.3.1.tar.gz 7.5 MB Without provenance Details for stockdex-1.3.1.tar.gz

Built distribution (wheel)

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

Total release size: 14.9 MB

Release files / stockdex-1.3.1.tar.gz

Download URL stockdex-1.3.1.tar.gz
Size 7.5 MB
Tags Source
SHA-256 checksum
How to use checksums
5f5f34a22afe366126383dd2356c08ed1c21fdf6d357b5d6a1c2c6a40e5d17b4
BLAKE2b-256 checksum
How to use checksums
77e9384cf47432fbf49491ef24f65184bed6749a590193f79b193fd9ccc96562
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.1-py3-none-any.whl

Download URL stockdex-1.3.1-py3-none-any.whl
Size 7.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
7ef1bce3efb4ebd10ce31c42c788e4647e3d834ef216c3e33dbe616bf64c2a2b
BLAKE2b-256 checksum
How to use checksums
7296f1040bca4c9d17f259d620ddaf3aa596e331a49c59c0bf260b8defb76cee
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.1

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.1 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