Full documentation: ahnazary.github.io/stockdex
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:
Stockdexprovides data from Yahoo Finance and other sources like Digrin, Finviz, Macrotrends and JustETF (for EU ETFs). -
Historical data:
Stockdexprovides a wide time range of data, e.g. Digrin and Macrotrends sources provide historical data in a span of years. -
Numerous data categories:
Stockdexprovides financials criteria including financial statements, earnings, dividends, stock splits, list of key executives, major shareholders and more. -
Plotting:
Stockdexplots financial data as bar, line and Sankey charts, and multiple plots can be combined in a Dash app.
Installation
Install the package using pip:
pip install stockdex -U
A quick check that the package works:
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 with 21 tools so Claude can fetch prices, financial statements, margins, dividends, insider trades, earnings reactions and more for you.
-
Claude Desktop: download
stockdex.mcpbfrom 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 via Pull Requests or Issues — every contribution helps.
Guidelines
There are no Guidelines as of now :)
❤️ Thank you in advance for your contribution! ❤️
Metadata
Release files for stockdex 1.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stockdex-1.5.0.tar.gz | 7.5 MB | Without provenance | Details for stockdex-1.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stockdex-1.5.0-py3-none-any.whl | Python 3 | none | any | Details for stockdex-1.5.0-py3-none-any.whl |
Total release size: 15.0 MB
Release files / stockdex-1.5.0.tar.gz
| Download URL | stockdex-1.5.0.tar.gz |
|---|---|
| Size | 7.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3f81e4463fe40ba6a014c6206cde8066d124438203471bb5aa2aa4a2019c6174
|
|
BLAKE2b-256 checksum How to use checksums |
e2705cde161cdd53d7ee5a8450bbc2bb16cc8c624577649d33e6b102a2187f09
|
| 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.5.0-py3-none-any.whl
| Download URL | stockdex-1.5.0-py3-none-any.whl |
|---|---|
| Size | 7.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dff44948b83a3bdc31fde7049e7b1d74c759289aa5bd4a3a070088c474559063
|
|
BLAKE2b-256 checksum How to use checksums |
1cc907835f737240d06585fe85abdbbe2b3ef9c9559232c0f8e919d2f7e7273a
|
| 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.5.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.