Metadata-Version: 2.5
Name: joltio
Version: 0.1.0
Summary: Python client for Joltio Data
Project-URL: Homepage, https://joltio.app/data
Project-URL: Documentation, https://joltio.app/data/docs
Project-URL: Repository, https://github.com/datons/python-joltio
Project-URL: Issues, https://github.com/datons/python-joltio/issues
Author-email: Jesús López <jesus.lopez@datons.com>
License-Expression: MIT
Keywords: api,data,datons,electricity,energy,esios,spain
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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 :: Scientific/Engineering
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: polars>=1.0
Requires-Dist: pydantic>=2.0
Provides-Extra: pandas
Requires-Dist: pandas>=2.0; extra == 'pandas'
Description-Content-Type: text/markdown

# joltio

Python client for [Joltio Data](https://joltio.app/data). The canonical endpoint is `https://api.joltio.app/data`.

## Installation

```bash
pip install joltio
```

## Quick start

```python
from joltio import Client

client = Client(api_key="jol_live_...")

# Query the electricity market clearing price
df = client.data.query(
    "SELECT datetime, price "
    "FROM omie.prices "
    "WHERE country = 'ES' AND datetime >= now() - INTERVAL 7 DAY "
    "LIMIT 100"
)

# Dataset metadata (schema, programs, stats)
meta = client.data.metadata()

# Search for units, companies, technologies
results = client.data.search("iberdrola")
```

## Authentication

Request a personal Data key from your Joltio workspace administrator.

Pass it directly or set `JOLTIO_API_KEY`. `DATONS_API_KEY` remains a fallback during migration.

```bash
export JOLTIO_API_KEY="jol_live_..."
```

```python
from joltio import Client

client = Client()  # picks up JOLTIO_API_KEY
```
