typed-kucoin 0.4.0

A fully typed, validated async client for the KuCoin API.

• Documentation: https://tribulnation.com/typed/kucoin
• Source Code: https://github.com/tribulnation/typed/tree/main/packages/kucoin

from typed_kucoin import KuCoin

async with KuCoin.new(public=True) as client:
  ticker = await client.spot.ticker(symbol='BTC-USDT')
  print(ticker['price'])

Why Typed KuCoin?

• 🎯 Precise Types: every request and response across Spot, Margin, Futures and Earn is a typed structure, not a bare dict.
• ✅ Runtime Validation: responses are checked against their schema by default, not just typed on paper.
• ⚡ Async First: one client shares an HTTP connection pool per KuCoin host (default, futures, broker) and lazily opens the Spot/Margin WebSocket connection only when a stream is used.
• 📚 Full Surface: Account, Spot, Margin, Futures, Earn, VIP Lending, Affiliate, Convert, Copy Trading and Broker each hang off their own attribute on KuCoin, alongside the Spot/Margin public and private WebSocket feeds.

Installation

pip install typed-kucoin

How To

• Fetch Market Data
• Listen To Streams
• Place & Manage Orders
• Manage Account Data
• Query & Manage Earn Instruments
• Deposits & Withdrawals
• Paginate Through Results

Reference

• API Keys Setup
• Async Usage
• Error Handling
• Environment Variables
• Timestamps

Design Philosophy

Typed KuCoin follows the principles outlined in this blog post.

Details matter. Developer experience matters.

License

MIT — see LICENSE.