Skip to main content

it is a lightweight Python library for extracting financial data from structured, publicly accessible stock information pages

Project description

https://img.shields.io/pypi/v/sfinance.svg Documentation Status

sfinance is a lightweight Python library for automating the extraction of financial tables from publicly accessible, structured HTML pages.

It uses Selenium and BeautifulSoup under the hood to simulate browser behavior and extract data into pandas DataFrames for further analysis.

This tool is intended for personal and educational use only.

Usage

Install the package (once published on PyPI):

pip install sfinance

Use it like this:

from sfinance.sfinance import SFinance
sf = SFinance("https://www.screener.in/")
t = sf.ticker("INFY")
print(t.get_overview())
print(t.get_income_statement())
sf.close()

This will return clean, structured pandas DataFrames from dynamically rendered pages. You are expected to supply valid URLs yourself. The package does not suggest or pre-configure any third-party endpoints.

Features

  • Uses Selenium to render dynamic content

  • Parses financial tables with BeautifulSoup

  • Extracts income statement, balance sheet, cash flow, shareholding, and company overview

  • Accesses company documents: announcements, annual reports, credit ratings, and concalls

  • Downloads documents (PDFs, HTML) directly to a local folder with flexible filters

  • Stock screener with custom financial queries (login required)

  • Outputs pandas DataFrames for analysis

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project 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

sfinance-0.2.1.tar.gz (19.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sfinance-0.2.1-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

File details

Details for the file sfinance-0.2.1.tar.gz.

File metadata

  • Download URL: sfinance-0.2.1.tar.gz
  • Upload date:
  • Size: 19.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sfinance-0.2.1.tar.gz
Algorithm Hash digest
SHA256 83084755c149cc46d6595e3fdb247aac9ff1e1bc516641c5e9c0b618ee466ab6
MD5 b97f8781b8426a99a42cb45e121d9368
BLAKE2b-256 87d3de3038c92ce190685811091115ced5f668757f1aed7e75c93ba989dab09a

See more details on using hashes here.

Provenance

The following attestation bundles were made for sfinance-0.2.1.tar.gz:

Publisher: python-publish.yml on shivakharbanda/sfinance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sfinance-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: sfinance-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 11.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sfinance-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e01f7747279efa4d6597edb2784681c6890591ce94d8f4fb559e6c2522472edd
MD5 ade3614aef5dbf327a022d8c3c3c8236
BLAKE2b-256 f50af80e837732e0d645d2db79712143cac6d74dab575c2f3e7e2d849947ff03

See more details on using hashes here.

Provenance

The following attestation bundles were made for sfinance-0.2.1-py3-none-any.whl:

Publisher: python-publish.yml on shivakharbanda/sfinance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page