# Frequenz Electricity Trading API Client
[![Build Status](https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/actions/workflows/ci.yaml)
[![PyPI Package](https://img.shields.io/pypi/v/frequenz-client-electricity-trading)](https://pypi.org/project/frequenz-client-electricity-trading/)
[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-client-electricity-trading-python/)
## Introduction
Electricity Trading API client for Python
The Frequenz Electricity Trading API client for Python is an easy-to-use Python interface built to interact with the Frequenz Electricity Trading API. It allows you to create orders, get market data, and manage your orders.
## Features
* **Create and manage gridpool orders**: Place new orders, update existing ones, and cancel orders when necessary.
* **Stream live data**: Get real-time updates on market data, including order books, trades, and market prices.
* **Retrieve historical data**: Access historical data on market trades.
## Supported Platforms
The following platforms are officially supported (tested):
* **Python:** 3.11
* **Operating System:** Ubuntu Linux 20.04
* **Architectures:** amd64, arm64
## Usage
### Installation
We assume you are on a system with Python available. If that is not the case,
please [download and install Python](https://www.python.org/downloads/) first.
To install the Frequenz Electricity Trading AP, you probably want to create a new virtual
environment first. For example, if you use a `sh` compatible shell, you can do this:
```sh
python3 -m venv .venv
. .venv/bin/activate
```
Then, just install using `pip`. Replace `VERSION` with the specific version you wish to install:
```sh
# Choose the version you want to install
VERSION=0.2.3
pip install frequenz-client-electricity-trading==$VERSION
```
## Documentation
For more information, please visit the [documentation
website](https://frequenz-floss.github.io/frequenz-client-electricity-trading-python/).
## Contributing
If you want to know how to build this project and contribute to it, please
check out the [Contributing Guide](CONTRIBUTING.md).
Raw data
{
"_id": null,
"home_page": null,
"name": "frequenz-client-electricity-trading",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.11",
"maintainer_email": null,
"keywords": "frequenz, python, lib, library, client-electricity-trading, client, api, python, trading, electricity-trading",
"author": null,
"author_email": "Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>",
"download_url": "https://files.pythonhosted.org/packages/18/77/42dddcf8d790cd6877b0a501867e740bc1baf2dc9b70f5735a1e6def9ca2/frequenz-client-electricity-trading-0.3.0.tar.gz",
"platform": null,
"description": "# Frequenz Electricity Trading API Client\n\n[![Build Status](https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/actions/workflows/ci.yaml)\n[![PyPI Package](https://img.shields.io/pypi/v/frequenz-client-electricity-trading)](https://pypi.org/project/frequenz-client-electricity-trading/)\n[![Docs](https://img.shields.io/badge/docs-latest-informational)](https://frequenz-floss.github.io/frequenz-client-electricity-trading-python/)\n\n## Introduction\n\nElectricity Trading API client for Python\nThe Frequenz Electricity Trading API client for Python is an easy-to-use Python interface built to interact with the Frequenz Electricity Trading API. It allows you to create orders, get market data, and manage your orders.\n\n## Features\n\n* **Create and manage gridpool orders**: Place new orders, update existing ones, and cancel orders when necessary.\n* **Stream live data**: Get real-time updates on market data, including order books, trades, and market prices.\n* **Retrieve historical data**: Access historical data on market trades.\n\n## Supported Platforms\n\nThe following platforms are officially supported (tested):\n\n* **Python:** 3.11\n* **Operating System:** Ubuntu Linux 20.04\n* **Architectures:** amd64, arm64\n\n## Usage\n\n### Installation\n\nWe assume you are on a system with Python available. If that is not the case,\nplease [download and install Python](https://www.python.org/downloads/) first.\n\n\nTo install the Frequenz Electricity Trading AP, you probably want to create a new virtual\nenvironment first. For example, if you use a `sh` compatible shell, you can do this:\n\n```sh\npython3 -m venv .venv\n. .venv/bin/activate\n```\n\nThen, just install using `pip`. Replace `VERSION` with the specific version you wish to install:\n\n```sh\n# Choose the version you want to install\nVERSION=0.2.3\npip install frequenz-client-electricity-trading==$VERSION\n```\n\n\n## Documentation\n\nFor more information, please visit the [documentation\nwebsite](https://frequenz-floss.github.io/frequenz-client-electricity-trading-python/).\n\n\n## Contributing\n\nIf you want to know how to build this project and contribute to it, please\ncheck out the [Contributing Guide](CONTRIBUTING.md).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Electricity Trading API client for Python",
"version": "0.3.0",
"project_urls": {
"Changelog": "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/releases",
"Documentation": "https://frequenz-floss.github.io/frequenz-client-electricity-trading-python/",
"Issues": "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/issues",
"Repository": "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python",
"Support": "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/discussions/categories/support"
},
"split_keywords": [
"frequenz",
" python",
" lib",
" library",
" client-electricity-trading",
" client",
" api",
" python",
" trading",
" electricity-trading"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1969d2e5be7b03cd9f35a47ed7b1118f0513b6190c7a16c165cb86d7f083714a",
"md5": "ffb98ead36618e04d554b16dd34d85d0",
"sha256": "ef7119b3a7d0386b8448dd70d093336bcea22acfd4c05e2e6b852d8a67c2511f"
},
"downloads": -1,
"filename": "frequenz_client_electricity_trading-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ffb98ead36618e04d554b16dd34d85d0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.11",
"size": 23111,
"upload_time": "2024-11-13T15:30:23",
"upload_time_iso_8601": "2024-11-13T15:30:23.264996Z",
"url": "https://files.pythonhosted.org/packages/19/69/d2e5be7b03cd9f35a47ed7b1118f0513b6190c7a16c165cb86d7f083714a/frequenz_client_electricity_trading-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "187742dddcf8d790cd6877b0a501867e740bc1baf2dc9b70f5735a1e6def9ca2",
"md5": "6898d7e0b609e08e4cc8b3a156399344",
"sha256": "14af7a39fab04847034e5d0c7523f599caf965785e9a72e40e2674cddd7d8a0f"
},
"downloads": -1,
"filename": "frequenz-client-electricity-trading-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "6898d7e0b609e08e4cc8b3a156399344",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.11",
"size": 27672,
"upload_time": "2024-11-13T15:30:28",
"upload_time_iso_8601": "2024-11-13T15:30:28.609763Z",
"url": "https://files.pythonhosted.org/packages/18/77/42dddcf8d790cd6877b0a501867e740bc1baf2dc9b70f5735a1e6def9ca2/frequenz-client-electricity-trading-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-13 15:30:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "frequenz-floss",
"github_project": "frequenz-client-electricity-trading-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "frequenz-client-electricity-trading"
}