Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sometastycake/asynchuobi
Unofficial python SDK for Huobi API
https://github.com/sometastycake/asynchuobi
api asynchronous crypto cryptocurrency exchange huobi huobi-api huobi-api-python huobi-python huobi-websocket huobitrade python sdk sdk-python spot trading
Last synced: 3 months ago
JSON representation
Unofficial python SDK for Huobi API
- Host: GitHub
- URL: https://github.com/sometastycake/asynchuobi
- Owner: sometastycake
- License: mit
- Created: 2022-10-06T15:22:27.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-02-08T12:49:15.000Z (over 1 year ago)
- Last Synced: 2024-07-22T02:42:45.466Z (4 months ago)
- Topics: api, asynchronous, crypto, cryptocurrency, exchange, huobi, huobi-api, huobi-api-python, huobi-python, huobi-websocket, huobitrade, python, sdk, sdk-python, spot, trading
- Language: Python
- Homepage: https://pypi.org/project/asynchuobi/
- Size: 235 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-crypto-trading-bots - asynchuobi - Python client for Huobi (REST and WebSocket). (Market data libraries)
- awesome-crypto-trading-bots - asynchuobi - Python client for Huobi (REST and WebSocket). (Market data libraries)
README
# Unofficial python SDK for Huobi API
[](https://github.com/sometastycake/asynchuobi/actions/workflows/ci.yml)
[]()
## Official documentation
[Documentation](https://huobiapi.github.io/docs/spot/v1/en/#change-log)
## Install
```bash
pip install asynchuobi
```
## Generic API
```python
from asynchuobi.api.clients.generic import GenericHuobiClient
async def main():
async with GenericHuobiClient() as client:
trading_symbols = await client.get_all_supported_trading_symbols()
```
## Market API
```python
from asynchuobi.api.clients.market import MarketHuobiClient
from asynchuobi.enums import CandleInterval
async def main():
async with MarketHuobiClient() as client:
candles = await client.get_candles('btcusdt', CandleInterval.min_1)
orderbook = await client.get_market_depth('btcusdt')
```
## Subuser API
```python
from asynchuobi.api.clients.subuser import SubUserHuobiClient
from asynchuobi.enums import ApiKeyPermission
async def main():
async with SubUserHuobiClient(
access_key='access_key',
secret_key='secret_key',
) as client:
subusers = await client.get_sub_users_list()
for subuser in subusers['data']:
keys = await client.api_key_query(subuser['uid'])
status = await client.get_sub_user_status(subuser['uid'])
balance = await client.get_account_balance_of_sub_user(subuser['uid'])
```
## Wallet API
```python
from asynchuobi.api.clients.wallet import WalletHuobiClient
async def main():
async with WalletHuobiClient(
access_key='access_key',
secret_key='secret_key',
) as client:
withdraw_response = await client.create_withdraw_request(
address='address',
currency='usdt',
amount=10
)
```
## Account API
```python
from asynchuobi.api.clients.account import AccountHuobiClient
from asynchuobi.enums import AccountTypeCode, Sort
async def main():
async with AccountHuobiClient(
access_key='access_key',
secret_key='secret_key',
) as client:
accounts = await client.accounts()
for account in accounts['data']:
balances = await client.account_balance(account_id=account['id'])
for account_type in (AccountTypeCode.spot, AccountTypeCode.flat):
total_valuation = await client.get_total_valuation_of_platform_assets(
account_type_code=account_type,
valuation_currency='BTC',
)
```
## Orders API
```python
from asynchuobi.api.clients.order import OrderHuobiClient
from asynchuobi.enums import OrderType
async def main():
async with OrderHuobiClient(
access_key='access_key',
secret_key='secret_key'
) as client:
response = await client.new_order(
account_id=account_id,
symbol='dogeusdt',
order_type=OrderType.buy_limit,
amount=20,
price=0.0660,
)
if response['status'] == 'ok':
order_id = response['data']
cancelling = await client.cancel_order(
order_id=order_id,
)
```
## Margin API
```python
from asynchuobi.api.clients.margin import MarginHuobiClient
async def main():
async with MarginHuobiClient(
access_key='access_key',
secret_key='secret_key',
) as client:
cross_margin_balance = await client.get_balance_of_cross_margin_account()
isolated_margin_balance = await client.get_balance_of_isolated_margin_account(
symbol='btcusdt',
)
```
## WebSocket
Client supports retrieving information about market data, such as candles, orderbook, trade details.
### Usage
```python
from asynchuobi.enums import CandleInterval
from asynchuobi.ws.ws_client import WSHuobiMarket
async def main():
async with WSHuobiMarket() as ws:
await ws.candlestick('btcusdt', CandleInterval.min_1).sub()
await ws.market_stats('btcusdt').sub()
await ws.market_ticker_info('btcusdt').sub()
await ws.orderbook('btcusdt').sub()
async for message in ws:
...
```
You can define callbacks which will called when message was received from websocket
```python
from typing import Dict
from asynchuobi.exceptions import WSHuobiError
from asynchuobi.ws.ws_client import WSHuobiMarket
def callback(msg: Dict):
print(msg)
def error(e: WSHuobiError):
print(e)
async def orderbook():
async with WSHuobiMarket() as ws:
await ws.orderbook('btcusdt').sub(callback=callback)
await ws.run_with_callbacks(error_callback=error)
```
You can also define async callback
### Retrieving information about account balance changing and about orders
Authentication is required
```python
from asynchuobi.ws.ws_client import WSHuobiAccount
async def main():
async with WSHuobiAccount('access_key', 'secret_key') as ws:
await ws.subscribe_account_change()
await ws.subscribe_order_updates('btcusdt')
async for message in ws:
...
```
With callbacks
```python
from asynchuobi.ws.ws_client import WSHuobiAccount
from asynchuobi.exceptions import WSHuobiError
def callback(message: dict):
print(message)
def error(e: WSHuobiError):
print(e)
async def main():
async with WSHuobiAccount('access_key', 'secret_key') as ws:
await ws.subscribe_account_change(
callback=callback,
)
await ws.run_with_callbacks(error_callback=error)
```
## License
MIT