stockfit-api 0.1.0__tar.gz

stockfit_api-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+.venv/
+stockfit_api/
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+BUILD.md
+.env*

stockfit_api-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: stockfit-api
+Version: 0.1.0
+Summary: Official Python SDK for the StockFit API: SEC EDGAR financials, filings, fund and ETF data, ownership, insider transactions, and earnings.
+Project-URL: Homepage, https://developer.stockfit.io
+Project-URL: Repository, https://github.com/Second-Dot-LLC/stockfit-api
+Author: Second Dot LLC
+License-Expression: MIT
+Keywords: api,edgar,etf,financials,fundamentals,sdk,sec,stockfit,stocks
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: attrs>=22.2.0
+Requires-Dist: httpx>=0.23.0
+Description-Content-Type: text/markdown
+
+# stockfit-api
+
+Official Python SDK for the [StockFit API](https://developer.stockfit.io): SEC EDGAR financials, filings, fund and ETF data, ownership, insider transactions, and earnings.
+
+Fully typed, generated from the StockFit OpenAPI spec. Sync and async, built on `httpx`.
+
+## Install
+
+```bash
+pip install stockfit-api
+```
+
+Requires Python 3.9+.
+
+## Usage
+
+```python
+from stockfit_api import AuthenticatedClient
+from stockfit_api.api.company import company_details
+from stockfit_api.api.financials import income_statement
+from stockfit_api.models import IncomeStatementPeriod
+
+client = AuthenticatedClient(base_url="https://api.stockfit.io/v1", token="fl_...")
+
+profile = company_details.sync(client=client, symbol="AAPL")
+print(profile.name)
+
+income = income_statement.sync(client=client, symbol="AAPL", period=IncomeStatementPeriod.ANNUAL)
+print(income)
+```
+
+Endpoint functions are grouped by area under `stockfit_api.api.*` (e.g. `company`, `financials`, `etfmf`, `sec_filings`, `ownership`, `earnings`, `price`). Query parameters are plain keyword arguments. Parameters with a fixed set of values (like `period`) are typed enums in `stockfit_api.models` (e.g. `IncomeStatementPeriod.ANNUAL`).
+
+### Async
+
+Every endpoint also exposes an async variant:
+
+```python
+profile = await company_details.asyncio(client=client, symbol="AAPL")
+```
+
+## Authentication
+
+Get an API token from your [StockFit developer account](https://developer.stockfit.io). `AuthenticatedClient` sends it as a Bearer token automatically.
+
+## License
+
+MIT, Copyright Second Dot LLC. Use of the StockFit API itself is governed by the StockFit terms of service and your subscription.

stockfit_api-0.1.0/README.md

@@ -0,0 +1,48 @@
+# stockfit-api
+
+Official Python SDK for the [StockFit API](https://developer.stockfit.io): SEC EDGAR financials, filings, fund and ETF data, ownership, insider transactions, and earnings.
+
+Fully typed, generated from the StockFit OpenAPI spec. Sync and async, built on `httpx`.
+
+## Install
+
+```bash
+pip install stockfit-api
+```
+
+Requires Python 3.9+.
+
+## Usage
+
+```python
+from stockfit_api import AuthenticatedClient
+from stockfit_api.api.company import company_details
+from stockfit_api.api.financials import income_statement
+from stockfit_api.models import IncomeStatementPeriod
+
+client = AuthenticatedClient(base_url="https://api.stockfit.io/v1", token="fl_...")
+
+profile = company_details.sync(client=client, symbol="AAPL")
+print(profile.name)
+
+income = income_statement.sync(client=client, symbol="AAPL", period=IncomeStatementPeriod.ANNUAL)
+print(income)
+```
+
+Endpoint functions are grouped by area under `stockfit_api.api.*` (e.g. `company`, `financials`, `etfmf`, `sec_filings`, `ownership`, `earnings`, `price`). Query parameters are plain keyword arguments. Parameters with a fixed set of values (like `period`) are typed enums in `stockfit_api.models` (e.g. `IncomeStatementPeriod.ANNUAL`).
+
+### Async
+
+Every endpoint also exposes an async variant:
+
+```python
+profile = await company_details.asyncio(client=client, symbol="AAPL")
+```
+
+## Authentication
+
+Get an API token from your [StockFit developer account](https://developer.stockfit.io). `AuthenticatedClient` sends it as a Bearer token automatically.
+
+## License
+
+MIT, Copyright Second Dot LLC. Use of the StockFit API itself is governed by the StockFit terms of service and your subscription.