Metadata-Version: 2.1
Name: eltyer
Version: 0.0.1
Summary: Official python client for ELTYER
Home-page: https://github.com/ELTYER/eltyer-python-client.git
Author: ELTYER
License: Apache License 2.0
Keywords: ELTYER,eltyer,investing-algorithm,INVESTING,BOT,ALGORITHM,FRAMEWORK,investing-bots,trading-bots
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3
Description-Content-Type: text/markdown
License-File: LICENSE

[![Tests](https://github.com/ELTYER/eltyer-python-client/actions/workflows/test.yml/badge.svg)](https://github.com/ELTYER/eltyer-python-client/actions/workflows/test.yml)

# Official ELTYER Python Client

> :warning: **Documentation outdated**: We are working hard on releasing v1.0.0. After 
> this release we will update the documentation at the website.

The ELTYER python client is a python library that can be used by your 
investing algorithm. With this client your can connect your algorithm to 
the ELTYER platform.

## Installation
You can install the client directly using pip:

```sh
pip install eltyer_client
```

## Usage
Example usage
```python
from eltyer import Client, OrderStatus

# Create a client and configure it with your algorithm api keys from ELTYER
client = Client()

# ****Configuration options****

# Configuration with dict
client.config.from_dict({"API_KEY": "<YOUR_API_KEY>"})

# Configuration with attribute setter
client.config.API_KEY = "<YOUR_API_KEY>"

# Configuration with environment variable 'ELTYER_API_KEY'
client.config.from_env()

# ****Configuration options****

# ****Available Operations****

# Start the ELTYER client
client.start()

# Get the api key context/environment
client.get_environment()

# Create a limit order
limit_order = client.create_limit_order(
    target_symbol="btc", amount=1, price=5, side="BUY",
)

# Create a market order (only sell market orders are supported)
market_order = client.create_market_order(target_symbol="btc", amount=1)

# Get positions
positions = client.get_positions()
position = client.get_position("btc")

# Get orders
orders = client.get_orders()
orders = client.get_orders(
    target_symbol="btc", status=OrderStatus.PENDING.value
)

# Get the portfolio
portfolio = client.get_portfolio()

# Stop the client
client.stop()
```






