Metadata-Version: 2.4
Name: typed-mexc
Version: 1.0.2
Summary: A fully typed, validated async client for the MEXC APIs.
Author-email: Marcel Claramunt <marcel@tribulnation.com>
License-Expression: GPL-3.0-only
Project-URL: Repository, https://github.com/tribulnation/mexc.git
Project-URL: Documentation, https://mexc.tribulnation.com
Project-URL: Website, https://tribulnation.com
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typed-core
Requires-Dist: betterproto2==0.9.*
Dynamic: license-file

# Typed MEXC

[![MEXC](https://raw.githubusercontent.com/tribulnation/mexc/refs/heads/main/media/mexc.svg)](https://www.mexc.com)

> A fully typed, validated async client for the MEXC spot and futures APIs

**Use autocomplete instead of documentation.**

```python
from mexc import MEXC

async with MEXC.new() as client:
  account = await client.spot.account()
  print(account['balances'][0]['asset'])
```

## Why Typed MEXC?

- **🎯 Precise Types**: Strong typing throughout, so your editor can help before runtime does.
- **✅ Automatic Validation**: Catch upstream API changes earlier, where they are easier to debug.
- **⚡ Async First**: Built for concurrent, network-heavy workflows.
- **🔒 Safer Usage**: Typed inputs and explicit errors reduce avoidable mistakes.
- **🎨 Better DX**: Clear `spot` / `futures` routing and stream surfaces.
- **📦 Practical Extras**: Pagination helpers and streams where they actually help.

## Package Shape

This package intentionally follows the way MEXC itself is split:

- `MEXC.spot` for spot market data, trading, user data, wallet methods, and spot streams
- `MEXC.futures` for futures market data, futures user data, and futures streams

Current limitation:

- futures trading REST methods are not available in the MEXC API

## Installation

```bash
pip install typed-mexc
```

## Documentation

> [**Read the docs**](https://mexc.tribulnation.com)
