Metadata-Version: 2.1
Name: gridstatusio
Version: 0.6.0
Summary: Python Client for GridStatus.io API
License: LICENSE
Keywords: energy,independent system operator
Author: Max Kanter
Author-email: kmax12@gmail.com
Maintainer: Max Kanter
Maintainer-email: kmax12@gmail.com
Requires-Python: >=3.9,<=3.12
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: gridstatus (>=0.20.0,<0.21.0)
Requires-Dist: numpy (==1.26.0)
Requires-Dist: pandas (>=1.3.0,<2.0.0)
Requires-Dist: requests (>=2.28.1,<3.0.0)
Requires-Dist: termcolor (==1.1.0)
Requires-Dist: tqdm (>=4.64.1,<5.0.0)
Project-URL: Issue Tracker, https://github.com/kmax12/gridstatusio/issues
Project-URL: Source Code, https://github.com/kmax12/gridstatusio/
Description-Content-Type: text/markdown

<p align="center">
<img width=75% src="/gridstatus-header.png" alt="gridstatus logo" />
</p>
<p align="center">
  <a href="https://github.com/gridstatus/gridstatusio/actions/workflows/tests.yaml" target="_blank">
        <img src="https://github.com/gridstatus/gridstatusio/actions/workflows/tests.yaml/badge.svg" alt="Tests" />
    </a>
   <a href="https://badge.fury.io/py/gridstatusio" target="_blank">
        <img src="https://badge.fury.io/py/gridstatusio.svg?maxAge=2592000" alt="PyPI version">
    </a>
</p>

# GridStatus.io Hosted API

Python client for accessing the [GridStatus.io Hosted API](https://www.gridstatus.io/api).

## Installation

gridstatusio supports python 3.9+. Install with pip:

```bash
pip install gridstatusio
```

Upgrade using the following command

```
python -m pip install --upgrade gridstatusio
```

## Getting Started

Check out this example notebook: [Getting Started](/Examples/Getting%20Started.ipynb)

Other Examples:

- [Stacked Net Load Visualization](/Examples/Stacked%20Net%20Load%20Visualization.ipynb)
- [CAISO April Net Load Analysis](/Examples/CAISO%20April%20Net%20Load.ipynb)
- [Resample Data to Different Frequencies](/Examples/Resample%20Data.ipynb)

## Open Source

If you prefer to use an open source library that fetches data directly from the source, you can check out the [github repo](https://github.com/kmax12/gridstatus). For more information on Hosted API vs Open Source API, please see this [guide](https://api.gridstatus.io/docs#section/Getting-Started/Open-Source)

## Get Help

We'd love to answer any usage or data access questions! Please let us know by emailing us at contact@gridstatus.io

