Struct HttpClient 

pub struct HttpClient { /* private fields */ }

Simplified client for IG Markets API with automatic authentication

This client handles all authentication complexity internally, including:

• Initial login
• OAuth token refresh
• Re-authentication when tokens expire
• Account switching
• Rate limiting for all API requests

Implementations

impl HttpClient

pub async fn new(config: Config) -> Result<Self, AppError>

Creates a new client and performs initial authentication

Arguments

• config - Configuration containing credentials and API settings

Returns

• Ok(Client) - Authenticated client ready to use
• Err(AppError) - If authentication fails

Errors

Returns AppError::Network if the underlying reqwest client cannot be built (e.g. the system TLS backend fails to initialize), or any AppError surfaced by the initial Auth::login call.

pub fn new_lazy(config: Config) -> Result<Self, AppError>

Creates a new client without performing initial authentication

Errors

Returns AppError::Network if the HTTP client cannot be constructed.

pub async fn ws_info(&self) -> Result<WebsocketInfo, AppError>

Gets WebSocket connection information for Lightstreamer, reusing the cached session.

Delegates to Auth::ws_info, which returns the cached session when it is valid and only logs in when needed.

Returns

• Ok(WebsocketInfo) - Server endpoint, authentication tokens, and account ID for the current session.
• Err(AppError) - If session retrieval (login / refresh) fails.

Errors

Returns AppError when the session cannot be retrieved.

pub async fn get_ws_info(&self) -> WebsocketInfo

👎Deprecated:

use ws_info() which reuses the cached session and returns a typed error instead of a default-on-error WebsocketInfo

Gets WebSocket connection information for Lightstreamer

Returns

• WebsocketInfo containing server endpoint, authentication tokens, and account ID

pub async fn get<T: DeserializeOwned>( &self, path: &str, version: Option<u8>, ) -> Result<T, AppError>

Makes a GET request

pub async fn post<B: Serialize, T: DeserializeOwned>( &self, path: &str, body: B, version: Option<u8>, ) -> Result<T, AppError>

Makes a POST request

pub async fn put<B: Serialize, T: DeserializeOwned>( &self, path: &str, body: B, version: Option<u8>, ) -> Result<T, AppError>

Makes a PUT request

pub async fn delete<T: DeserializeOwned>( &self, path: &str, version: Option<u8>, ) -> Result<T, AppError>

Makes a DELETE request

pub async fn post_with_delete_method<B: Serialize, T: DeserializeOwned>( &self, path: &str, body: B, version: Option<u8>, ) -> Result<T, AppError>

Makes a POST request with _method: DELETE header

This is required by IG API for closing positions, as they don’t support DELETE requests with a body. Instead, they use POST with a special header.

Arguments

• path - API endpoint path
• body - Request body to send
• version - API version to use

Returns

Deserialized response of type T

pub async fn request<B: Serialize, T: DeserializeOwned>( &self, method: Method, path: &str, body: Option<B>, version: Option<u8>, ) -> Result<T, AppError>

Makes a request with custom API version

pub async fn switch_account( &self, account_id: &str, default_account: Option<bool>, ) -> Result<(), AppError>

Switches to a different trading account

pub async fn get_session(&self) -> Result<Session, AppError>

Gets the current session

pub async fn logout(&self) -> Result<(), AppError>

Logs out

pub fn auth(&self) -> &Auth

Gets Auth reference