Skip to main content

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

Stockdex logo with three ascending candlesticks

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: 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: Stockdex plots 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 24 tools so Claude can fetch prices, financial statements, margins, dividends, insider trades, earnings reactions, analyst forecasts, European ETF profiles and more 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 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.6.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.6.0
File Size Uploaded Provenance Actions
stockdex-1.6.0.tar.gz 114.9 kB Without provenance Details for stockdex-1.6.0.tar.gz

Built distribution (wheel)

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

Total release size: 257.9 kB

Release files / stockdex-1.6.0.tar.gz

Download URL stockdex-1.6.0.tar.gz
Size 114.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f84287e3f80bf93e64925d2297f27a9a8ac59af168b20939e7367299cd3417ab
BLAKE2b-256 checksum
How to use checksums
058bf4028d5efc013e598fd6db1ff962eb4eef27a0b593cfc6f28b7fde208abe
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.6.0-py3-none-any.whl

Download URL stockdex-1.6.0-py3-none-any.whl
Size 143.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cdfe31c028f2d770d9ec0ffa5a6773815acee20c77c6b5ac3fc68bfd58f11948
BLAKE2b-256 checksum
How to use checksums
3c9024f6f74fbbcee7aa2957889112e2ad462171886b10981751849fd64d82bf
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.6.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.6.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