maxt 0.3.2

One Rust API for Upbit, Bithumb, Binance, and Hyperliquid market data, accounts, and orders.
Documentation
# maxt

[English]README.md | [한국어]README.ko.md

`maxt` is a typed asynchronous API for market data, accounts, orders, and
streams across Binance, Upbit, Bithumb, and Hyperliquid. Rust is the core;
Python, Dart/Flutter, and TypeScript expose the same generated contract.

## What is supported

| Exchange | General adapter boundary | Start here |
| --- | --- | --- |
| **Binance** | Spot and USD-M perpetual futures | `BinanceAdapter::spot()`; this README's default example |
| **Upbit** | Spot in Korea, Singapore, Indonesia, and Thailand | `UpbitAdapter::new()` or `with_region(...)` |
| **Bithumb** | Spot; provider-specific KRW account and order APIs | `BithumbAdapter::new()` |
| **Hyperliquid** | Spot and perpetual futures on mainnet or testnet | `HyperliquidAdapter::new()` or `testnet()` |

Every built-in adapter supports a documented subset of the common `Client`
API. Public market data and market streams need no account configuration.
Account reads, orders, and transfers use provider-specific configuration and
may be limited by region, venue, or account permissions. Hyperliquid also has
address-scoped Info reads that need a public address but no local signature;
its signed actions need a signer. See [provider support](docs/providers.md) for
the exact constructors and boundaries; see the generated
[endpoint reference](bindings/common/generated/api.md) for per-operation
coverage and validation state.

Binance testnet constructors, Hyperliquid HIP-3 DEXes, and outcome assets are
not exposed. The endpoint reference distinguishes mapped operations from the
other exchange products that remain planned or unmapped.

## Why maxt

`maxt` is designed for applications that work with multiple exchanges. Switching
exchanges or languages should not mean learning another SDK.

- Use common operations with the same API shape, models, errors, and stream contract across exchanges and supported languages.
- Access common operations through `Client` and exchange-specific capabilities through typed adapters.
- Generate language-native public APIs and contracts from one schema, then verify them against the compiled native API.

## Quick start: Binance Spot

The default example is a credential-free Binance Spot `BTC/USDT` read. It
combines a common operation (`ticker`) and a Binance-only operation
(`spot_average_price`) without placing an order.

## Install for Rust

Rust 1.85 or newer is required.

```toml
[dependencies]
maxt = "0.2.1"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
```

```rust,no_run
use maxt::adapters::BinanceAdapter;
use maxt::{Client, Exchange, Market};

#[tokio::main]
async fn main() -> maxt::Result<()> {
    let client = Client::new(BinanceAdapter::spot());
    let market = Market::spot(Exchange::Binance, "BTC", "USDT");

    let ticker = client.ticker(&market).await?;
    let average = client.adapter().spot_average_price(&market).await?;

    println!("{}", ticker.last_price);
    println!("{}-minute average: {}", average.minutes, average.price);
    Ok(())
}
```

`ticker()` is common. `spot_average_price()` is Binance Spot-specific and is
available through `Client::adapter()`.

Run the public REST example:

```sh
cargo run --example public_rest
```

Pass another supported public exchange and pair to explore it without changing
code: `cargo run --example public_rest -- upbit BTC KRW`.

## Language packages

| Language | Package guide | Runnable Binance example |
| --- | --- | --- |
| Rust | This README and [Getting started]docs/getting-started.md | [`examples/public_rest.rs`]examples/public_rest.rs |
| Python | [Python package guide]bindings/python/README.md | [`bindings/python/examples/binance_public_ticker.py`]bindings/python/examples/binance_public_ticker.py |
| Dart / Flutter | [Dart package guide]bindings/dart/README.md | [`bindings/dart/example/main.dart`]bindings/dart/example/main.dart |
| TypeScript | [TypeScript package guide]bindings/typescript/README.md | [`bindings/typescript/examples/binance-public-ticker.mjs`]bindings/typescript/examples/binance-public-ticker.mjs |

The Dart package supports Android, iOS, Linux, macOS, Windows, and Web. The
TypeScript package supports Node.js and browser WebAssembly.

## Documentation

- [Getting started]docs/getting-started.md
- [Common API]docs/common-api.md
- [Provider support]docs/providers.md
- [Endpoint coverage reference]bindings/common/generated/api.md
- Rust API: `cargo doc --open`
- [Python]bindings/python/README.md
- [Dart / Flutter]bindings/dart/README.md
- [TypeScript]bindings/typescript/README.md
- [Browser relay]relay/README.md
- [Examples]examples/
- [Changelog]CHANGELOG.md
- [Contributing]CONTRIBUTING.md

## License

MIT. See [LICENSE](LICENSE).