Metadata-Version: 2.4
Name: crypto-connector
Version: 0.4.4
Summary: A lightweight library that works as a connector to several crypto exchanges APIs.
Project-URL: Homepage, https://github.com/Izem0/crypto-connector
Project-URL: Issues, https://github.com/Izem0/crypto-connector/issues
Author-email: Izem Mangione <izem.mangione@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.7.3
Requires-Dist: requests>=2.32.1
Description-Content-Type: text/markdown

# Crypto-connector

![tests](https://github.com/Izem0/crypto-connector/actions/workflows/tests.yml/badge.svg)
[![PyPI version](https://img.shields.io/pypi/v/crypto-connector)](https://pypi.python.org/pypi/crypto-connector)
[![Python version](https://img.shields.io/pypi/pyversions/crypto-connector)](https://www.python.org/downloads/)
[![Code Style](https://img.shields.io/badge/code_style-black-black)](https://black.readthedocs.io/en/stable/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)


This is a lightweight library that works as a connector to Binance SPOT and HTX SPOT APIs.

- Supported APIs:
    - [Binance SPOT API](https://developers.binance.com/docs/binance-spot-api-docs/rest-api)
    - [HTX SPOT API](https://www.htx.com/en-in/opend/newApiPages/)

## Installation

```bash
pip install crypto-connector
```

## Usage examples

### Public endpoints
```python
import crypto_connector as cc

exc = cc.Binance()
# exc = cc.HTX()

# get server time
print(exc.get_server_time())

# get last 200 klines of ETHUSDT with 1d timeframe
print(exc.klines("ETHUSDT", "1d"))
```

### Private endpoints
API key/secret are required for private endpoints.
```python
import crypto_connector as cc

# some binance API endpoints require both sub and master accounts API key/secret.
# Therefore user needs to create a subaccount and provide subaccount api key, 
# subaccount api secret, subaccount email, master account api key and 
# master account api secret to the Binance constructor
exc = cc.Binance(
    sub_api_key="",
    sub_api_secret="",
    sub_email="",
    master_api_key="",
    master_api_secret="",
)
# exc = cc.HTX(
#     api_key="",
#     api_secret="",
# )

# get api key info
print(exc.get_api_key_info())

# get balance
print(exc.get_balance())

# post a new order
order = exc.place_order("ETHUSDT", type="limit", side="buy", qty=0.015, price=1000)
print(order)

# get open orders
print(exc.get_open_orders())
```

## Limitation

- This library is not intended to be comprehensive, I use it mainly for my personal projects
- Not all endpoints of the different APIs are supported
- Websocket and Futures are not supported