Struct AxRawHttpClient 

pub struct AxRawHttpClient { /* private fields */ }

Raw HTTP client for low-level AX Exchange API operations.

This client handles request/response operations with the AX Exchange API, returning venue-specific response types. It does not parse to Nautilus domain types.

Implementations

impl AxRawHttpClient

pub fn base_url(&self) -> &str

Returns the base URL for this client.

pub fn cancel_all_requests(&self)

Cancel all pending HTTP requests.

pub fn cancellation_token(&self) -> &CancellationToken

Get the cancellation token for this client.

pub fn new( base_url: Option<String>, orders_base_url: Option<String>, timeout_secs: Option<u64>, max_retries: Option<u32>, retry_delay_ms: Option<u64>, retry_delay_max_ms: Option<u64>, proxy_url: Option<String>, ) -> Result<Self, AxHttpError>

Creates a new AxRawHttpClient using the default Ax HTTP URL.

Errors

Returns an error if the retry manager cannot be created.

pub fn with_credentials( api_key: String, api_secret: String, base_url: Option<String>, orders_base_url: Option<String>, timeout_secs: Option<u64>, max_retries: Option<u32>, retry_delay_ms: Option<u64>, retry_delay_max_ms: Option<u64>, proxy_url: Option<String>, ) -> Result<Self, AxHttpError>

Creates a new AxRawHttpClient configured with credentials.

Errors

Returns an error if the HTTP client cannot be created.

pub fn set_session_token(&self, token: String)

Sets the session token for authenticated requests.

The session token is obtained through the login flow and used for bearer token authentication.

Panics

Panics if the internal lock is poisoned (indicates a panic in another thread).

pub async fn get_whoami(&self) -> Result<AxWhoAmI, AxHttpError>

Fetches the current authenticated user information.

Endpoint

GET /whoami

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_instruments( &self, ) -> Result<AxInstrumentsResponse, AxHttpError>

Fetches all available instruments.

Endpoint

GET /instruments

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_balances(&self) -> Result<AxBalancesResponse, AxHttpError>

Fetches all account balances for the authenticated user.

Endpoint

GET /balances

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_positions(&self) -> Result<AxPositionsResponse, AxHttpError>

Fetches all open positions for the authenticated user.

Endpoint

GET /positions

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_tickers(&self) -> Result<AxTickersResponse, AxHttpError>

Fetches all tickers.

Endpoint

GET /tickers

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_ticker(&self, symbol: &str) -> Result<AxTicker, AxHttpError>

Fetches a single ticker by symbol.

Endpoint

GET /ticker?symbol=<symbol>

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_instrument( &self, symbol: &str, ) -> Result<AxInstrument, AxHttpError>

Fetches a single instrument by symbol.

Endpoint

GET /instrument?symbol=<symbol>

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn authenticate( &self, api_key: &str, api_secret: &str, expiration_seconds: i32, ) -> Result<AxAuthenticateResponse, AxHttpError>

Authenticates using API key and secret to obtain a session token.

Endpoint

POST /authenticate

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn authenticate_with_totp( &self, api_key: &str, api_secret: &str, expiration_seconds: i32, totp: Option<&str>, ) -> Result<AxAuthenticateResponse, AxHttpError>

Authenticates with the AX Exchange API using API key credentials and optional 2FA.

Endpoint

POST /authenticate

Errors

Returns an error if:

• 400: 2FA is required but totp was not provided.
• 401: Invalid credentials.

pub async fn place_order( &self, request: &PlaceOrderRequest, ) -> Result<AxPlaceOrderResponse, AxHttpError>

Places a new order.

Endpoint

POST /place_order (orders base URL)

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn cancel_order( &self, order_id: &str, ) -> Result<AxCancelOrderResponse, AxHttpError>

Cancels an existing order.

Endpoint

POST /cancel_order (orders base URL)

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_open_orders(&self) -> Result<AxOpenOrdersResponse, AxHttpError>

Fetches all open orders.

Endpoint

GET /open_orders (orders base URL)

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_fills(&self) -> Result<AxFillsResponse, AxHttpError>

Fetches all fills/trades.

Endpoint

GET /fills

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_candles( &self, symbol: &str, start_timestamp_ns: i64, end_timestamp_ns: i64, candle_width: AxCandleWidth, ) -> Result<AxCandlesResponse, AxHttpError>

Fetches historical candles.

Endpoint

GET /candles

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_current_candle( &self, symbol: &str, candle_width: AxCandleWidth, ) -> Result<AxCandle, AxHttpError>

Fetches the current (incomplete) candle.

Endpoint

GET /candles/current

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_last_candle( &self, symbol: &str, candle_width: AxCandleWidth, ) -> Result<AxCandle, AxHttpError>

Fetches the last completed candle.

Endpoint

GET /candles/last

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_funding_rates( &self, symbol: &str, start_timestamp_ns: i64, end_timestamp_ns: i64, ) -> Result<AxFundingRatesResponse, AxHttpError>

Fetches funding rates for a symbol.

Endpoint

GET /funding-rates

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_risk_snapshot( &self, ) -> Result<AxRiskSnapshotResponse, AxHttpError>

Fetches the current risk snapshot.

Endpoint

GET /risk-snapshot

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_transactions( &self, transaction_types: Vec<String>, ) -> Result<AxTransactionsResponse, AxHttpError>

Fetches transactions filtered by type.

Endpoint

GET /transactions

Errors

Returns an error if the request fails or the response cannot be parsed.

Trait Implementations

impl Debug for AxRawHttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AxRawHttpClient

fn default() -> Self

Returns the “default value” for a type.