Struct Auth 

pub struct Auth { /* private fields */ }

Authentication manager for IG Markets API

Handles all authentication operations including:

• Login with API v2 or v3
• Automatic OAuth token refresh
• Account switching
• Session management
• Rate limiting for API requests

Implementations

impl Auth

pub fn new(config: Arc<Config>) -> Self

Creates a new Auth instance

Arguments

• config - Configuration containing credentials and API settings

pub async fn get_ws_info(&self) -> WebsocketInfo

Gets the WebSocket password for Lightstreamer authentication

Returns

• WebSocket password in format “CST-{cst}|XST-{token}” or empty string if session is not available

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

Gets the current session, ensuring tokens are valid

This method automatically refreshes expired OAuth tokens or re-authenticates if needed.

Returns

• Ok(Session) - Valid session with fresh tokens
• Err(AppError) - If authentication fails

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

Performs initial login to IG Markets API

Automatically detects API version from config and uses appropriate authentication method.

Returns

• Ok(Session) - Authenticated session
• Err(AppError) - If login fails

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

Refreshes an expired OAuth token with automatic retry on rate limit

If refresh fails (e.g., refresh token expired), performs full re-authentication.

Returns

• Ok(Session) - New session with refreshed tokens
• Err(AppError) - If refresh and re-authentication both fail

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

Switches to a different trading account

Arguments

• account_id - The account ID to switch to
• default_account - Whether to set as default account

Returns

• Ok(Session) - New session for the switched account
• Err(AppError) - If account switch fails

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

Logs out and clears the current session