Metadata-Version: 2.4
Name: quantjourney
Version: 2.4.0
Summary: QuantJourney SDK — Python client for api.quantjourney.cloud
Project-URL: Homepage, https://quantjourney.cloud
Project-URL: Documentation, https://api.quantjourney.cloud/docs
Project-URL: Repository, https://github.com/QuantJourneyOrg/_repo_qj_sdk
Project-URL: Bug Tracker, https://github.com/QuantJourneyOrg/_repo_qj_sdk/issues
Project-URL: Changelog, https://github.com/QuantJourneyOrg/_repo_qj_sdk/blob/main/CHANGELOG.md
Project-URL: Examples, https://github.com/QuantJourneyOrg/qj_api_examples
Project-URL: Terms of Use, https://quantjourney.cloud/terms-of-usage
Project-URL: Privacy Policy, https://quantjourney.cloud/privacy-policy
Author-email: Jakub Polec <jakub@quantjourney.pro>
Maintainer-email: QuantJourney <support@quantjourney.pro>
License: Proprietary
License-File: LICENSE
Keywords: api,data,finance,quant,quantjourney,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.28
Provides-Extra: all
Requires-Dist: httpx>=0.24; extra == 'all'
Requires-Dist: pandas>=1.5; extra == 'all'
Provides-Extra: async
Requires-Dist: httpx>=0.24; extra == 'async'
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: httpx>=0.24; extra == 'dev'
Requires-Dist: pandas>=1.5; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Provides-Extra: pandas
Requires-Dist: pandas>=1.5; extra == 'pandas'
Description-Content-Type: text/markdown

# quantjourney

Python SDK for [api.quantjourney.cloud](https://api.quantjourney.cloud) — financial data API.

Version `2.4.0` introduces unified OAuth 2.0 authentication: API keys are now exchanged for short-lived JWTs at init, eliminating raw key transmission on every request.

## Install

```bash
pip install quantjourney
```

## Quick Start

### With API key

```python
from quantjourney.sdk import QuantJourneyAPI

qj = QuantJourneyAPI(token="your-api-key")
prices = qj.fmp.get_historical_prices(symbol="AAPL")
```

### With email / password

```python
from quantjourney.sdk import QuantJourneyAPI

qj = QuantJourneyAPI()
qj.auth.login(email="you@example.com", password="...")
prices = qj.fmp.get_historical_prices(symbol="AAPL")
```

## User Portal

Manage your account at [users.quantjourney.cloud](https://users.quantjourney.cloud):

- **API Keys** — generate and manage API keys for SDK access
- **Data Sources** — add your own keys for premium connectors (FMP, EOD, Tiingo, …)
- **AI Models** — add your OpenAI / Anthropic / Google AI keys for Copilot

Free connectors (FRED, SEC, OECD, World Bank, …) work without additional configuration.

## Connector Coverage

The public SDK now exposes connector clients including:

- Market data: `fmp`, `eod`, `yf`, `tiingo`, `finnhub`, `coingecko`
- Macro / public data: `fred`, `bea`, `bls`, `census`, `eia`, `usda`, `worldbank`, `oecd`, `dbnomics`, `imf`
- Rates / central banks: `treasury`, `ecb`, `boc`, `rba`, `snb`, `eurostat`
- Regulatory / reference: `sec`, `openfigi`, `finra`, `cftc`, `multpl`

Connector availability still depends on your plan and configured provider secrets where applicable.

See the [Changelog](https://github.com/QuantJourneyOrg/_repo_qj_sdk/blob/main/CHANGELOG.md) for release notes and [Usage Guide](https://github.com/QuantJourneyOrg/_repo_qj_sdk/blob/main/USAGE.md) for additional examples.

## Migration from 1.x

```python
# Before (1.x):
from quantjourney_sdk import QuantJourneyAPI

# After (2.0):
from quantjourney.sdk import QuantJourneyAPI
```

## Links

- [API Documentation](https://api.quantjourney.cloud/docs)
- [Examples](https://github.com/QuantJourneyOrg/qj_api_examples)
- [Terms of Use](https://quantjourney.cloud/terms-of-usage)
- [Privacy Policy](https://quantjourney.cloud/privacy-policy)
