Struct RestClient

Source

pub struct RestClient { /* private fields */ }

Expand description

Async REST client for AsterDex Futures V3 API.

Supports both public (unsigned) and authenticated (signed) endpoints. Use new_public for public-only access, from_env or new for authenticated access.

Implementations§

Source §

impl RestClient

Source

pub fn from_env() -> Result<Self, AsterDexError>

Construct authenticated client from environment variables.

Reads: ASTERDEX_USER, ASTERDEX_SIGNER_ADDRESS, ASTERDEX_SIGNER_PRIVATE_KEY. Optional: ASTERDEX_BASE_URL (defaults to https://fapi.asterdex.com).

§Errors

AsterDexError::ConfigError if any required env var is missing or invalid

Source

pub fn new( base_url: &str, credentials: Credentials, ) -> Result<Self, AsterDexError>

Construct authenticated client with explicit base URL and credentials.

§Errors

AsterDexError::ConfigError if base URL is invalid

Source

pub fn new_public(base_url: &str) -> Result<Self, AsterDexError>

Construct unauthenticated (public) client.

Only public endpoints (unsigned GET) will work. Signed endpoints will return AsterDexError::ConfigError.

§Errors

AsterDexError::ConfigError if base URL is invalid

Source

pub async fn raw_get( &self, path: &str, params: &[(&str, &str)], ) -> Result<ApiResponse<Value>, AsterDexError>

Make an unsigned GET request and return the raw JSON response.

Use when the typed response struct does not cover all fields, or for debugging. Error mapping (429 → RateLimited, etc.) applies identically to typed methods.

§Errors

AsterDexError::ApiError — if the server returns a 4xx error with {code, msg}
AsterDexError::RateLimited — if the server returns 429
AsterDexError::NetworkError — if a network-level error occurs

§Examples

let resp = client.raw_get("/fapi/v3/exchangeInfo", &[]).await?;
println!("{}", resp.data);

Source

pub async fn raw_post( &self, path: &str, params: &[(&str, &str)], ) -> Result<ApiResponse<Value>, AsterDexError>

Make an unsigned POST request and return the raw JSON response.

§Errors

AsterDexError::ApiError — if the server returns a 4xx error with {code, msg}
AsterDexError::RateLimited — if the server returns 429
AsterDexError::NetworkError — if a network-level error occurs

Source

pub async fn raw_delete( &self, path: &str, params: &[(&str, &str)], ) -> Result<ApiResponse<Value>, AsterDexError>

Make an unsigned DELETE request and return the raw JSON response.

§Errors

AsterDexError::ApiError — if the server returns a 4xx error with {code, msg}
AsterDexError::RateLimited — if the server returns 429
AsterDexError::NetworkError — if a network-level error occurs

Source

pub async fn raw_signed_get( &self, path: &str, params: &[(&str, &str)], ) -> Result<ApiResponse<Value>, AsterDexError>

Make a signed GET request and return the raw JSON response (EIP-712 authenticated).

Requires credentials to be set (use RestClient::from_env()).

§Errors

AsterDexError::ConfigError — if credentials are not set
AsterDexError::ApiError — if the server returns a 4xx error with {code, msg}
AsterDexError::RateLimited — if the server returns 429
AsterDexError::NetworkError — if a network-level error occurs

Source

pub async fn raw_signed_post( &self, path: &str, params: &[(&str, &str)], ) -> Result<ApiResponse<Value>, AsterDexError>

Make a signed POST request and return the raw JSON response.

Requires credentials to be set (use RestClient::from_env()).

§Errors

AsterDexError::ConfigError — if credentials are not set
AsterDexError::ApiError — if the server returns a 4xx error with {code, msg}
AsterDexError::RateLimited — if the server returns 429
AsterDexError::NetworkError — if a network-level error occurs

Source

pub async fn raw_signed_delete( &self, path: &str, params: &[(&str, &str)], ) -> Result<ApiResponse<Value>, AsterDexError>

Make a signed DELETE request and return the raw JSON response.

Requires credentials to be set (use RestClient::from_env()).

§Errors

AsterDexError::ConfigError — if credentials are not set
AsterDexError::ApiError — if the server returns a 4xx error with {code, msg}
AsterDexError::RateLimited — if the server returns 429
AsterDexError::NetworkError — if a network-level error occurs

Source §

impl RestClient

Source

pub async fn get_server_time( &self, ) -> Result<ApiResponse<ServerTimeResponse>, AsterDexError>

Get server time in milliseconds.

Use to detect clock drift before placing orders. This is a public endpoint (no authentication required).

Source