asterdex-sdk 0.1.0

AsterDex Futures SDK v3 — Rust async client for REST and WebSocket APIs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! # asterdex-sdk
//!
//! Async Rust client for the [AsterDex](https://github.com/seltosoj/asterdex_sdk_v3_rust) Futures API v3.
//!
//! Supports REST endpoints and WebSocket market/user-data streams,
//! with EIP-712 request signing via the [alloy](https://github.com/alloy-rs/alloy) crate.
//!
//! ## Quick start
//!
//! ```rust,no_run
//! use asterdex_sdk::{Credentials, FuturesClient};
//!
//! #[tokio::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//!     let creds = Credentials::from_env()?;
//!     let client = FuturesClient::new(creds, None)?;
//!
//!     let server_time = client.get_server_time().await?;
//!     println!("Server time: {}", server_time.server_time);
//!     Ok(())
//! }
//! ```
//!
//! ## Environment variables
//!
//! | Variable | Required | Description |
//! |---|---|---|
//! | `ASTERDEX_PRIVATE_KEY` | Yes | Hex-encoded private key for EIP-712 signing |
//! | `ASTERDEX_BASE_URL` | No | Override base URL (defaults to mainnet) |
//! | `ASTERDEX_CHAIN_ID` | No | Chain ID (defaults to `1666`) |

// US-001: SDK crate root — public re-exports

mod auth;
mod rest;
mod ws;
pub mod futures;
pub mod spot;
/// Backward-compatibility re-export of futures::models — use futures::models directly.
pub mod models;
pub(crate) mod endpoints;

pub use auth::Credentials;
pub use rest::client::RestClient;
pub use futures::FuturesClient;
pub use rest::error::AsterDexError;
pub use rest::response::ApiResponse;
pub use ws::client::{UserDataStream, WebSocketClient, WebSocketStream};

// Re-export key model types at crate root for convenience
pub use futures::models::trading::{
    CancelOrderParams, CancelOrderResponse, EmptyResponse, ListenKeyResponse, ModifyOrderParams,
    OrderResponse, PlaceOrderParams, PositionResponse,
};
pub use futures::models::market::{
    DepthResponse, ExchangeInfoResponse, Kline, KlineInterval, MarkPriceResponse, MarkPriceShape,
    PingResponse, ServerTimeResponse, Ticker24hrResponse, Ticker24hrShape,
};
pub use futures::models::account::{Balance, LeverageBracket, SetLeverageResponse};
pub use futures::models::websocket::WebSocketMessage;
pub use futures::models::user_data::UserDataEvent;