Metadata-Version: 2.4
Name: financialmodelingprep-sdk
Version: 0.1.0
Summary: Async Python SDK for the Financial Modeling Prep stable API.
Keywords: fmp,financial-modeling-prep,finance,stocks,sdk
Author: Aaksh Ranjan
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Dist: aiohttp>=3.14.3
Requires-Dist: pydantic>=2.13.5
Requires-Dist: tenacity>=9.1.4
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/AakshRanjan/Finance-Intelligence-Graph
Project-URL: Repository, https://github.com/AakshRanjan/Finance-Intelligence-Graph
Project-URL: Issues, https://github.com/AakshRanjan/Finance-Intelligence-Graph/issues
Project-URL: Changelog, https://github.com/AakshRanjan/Finance-Intelligence-Graph/blob/master/FMP-SDK/CHANGELOG.md
Description-Content-Type: text/markdown

# financialmodelingprep-sdk

Async Python SDK for the [Financial Modeling Prep](https://site.financialmodelingprep.com/) stable API. Responses are validated with Pydantic; HTTP calls retry through a shared session.

## Install

```bash
pip install financialmodelingprep-sdk
```

Requires Python 3.12+. You need an FMP API key.

## Usage

```python
import asyncio

from fmp_sdk import FMPSession


async def main() -> None:
    async with FMPSession("YOUR_API_KEY") as session:
        bars = await session.chart("AAPL").historical_price_eod_light()
        print(bars[0].date, bars[0].price)


asyncio.run(main())
```

`FMPSession.chart(symbol)` binds a symbol so you do not pass it on every call. You can also pass `symbol=` per request.

## Versioning

Releases are cut automatically from Conventional Commits that touch this package:

- `feat:` — minor
- `fix:` / `perf:` — patch
- `feat!:` or a `BREAKING CHANGE:` footer — major (stays 0.x until 1.0)

See [CHANGELOG.md](CHANGELOG.md) for published versions.
