ig-client 0.11.3

This crate provides a client for the IG Markets API
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

/******************************************************************************
   Author: Joaquín Béjar García
   Email: jb@taunais.com
   Date: 8/3/26
******************************************************************************/

//! Indicative costs and charges service interface for IG Markets API
//!
//! This module defines the interface for retrieving indicative costs and charges
//! information for opening, closing, and editing positions. This is required
//! for regulatory compliance in certain jurisdictions.

use crate::error::AppError;
use crate::model::requests::{CloseCostsRequest, EditCostsRequest, OpenCostsRequest};
use crate::model::responses::{
    CostsHistoryResponse, DurableMediumResponse, IndicativeCostsResponse,
};
use async_trait::async_trait;

/// Service for retrieving indicative costs and charges from the IG Markets API
///
/// This service provides regulatory cost information for trading activities,
/// including costs for opening, closing, and editing positions.
#[async_trait]
pub trait CostsService: Send + Sync {
    /// Returns indicative costs and charges for opening a position
    ///
    /// # Arguments
    /// * `request` - The request containing position details
    ///
    /// # Returns
    /// * `Ok(IndicativeCostsResponse)` - The indicative costs and charges
    /// * `Err(AppError)` - If the request fails
    async fn get_indicative_costs_open(
        &self,
        request: &OpenCostsRequest,
    ) -> Result<IndicativeCostsResponse, AppError>;

    /// Returns indicative costs and charges for closing a position
    ///
    /// # Arguments
    /// * `request` - The request containing position details
    ///
    /// # Returns
    /// * `Ok(IndicativeCostsResponse)` - The indicative costs and charges
    /// * `Err(AppError)` - If the request fails
    async fn get_indicative_costs_close(
        &self,
        request: &CloseCostsRequest,
    ) -> Result<IndicativeCostsResponse, AppError>;

    /// Returns indicative costs and charges for editing a position
    ///
    /// # Arguments
    /// * `request` - The request containing position edit details
    ///
    /// # Returns
    /// * `Ok(IndicativeCostsResponse)` - The indicative costs and charges
    /// * `Err(AppError)` - If the request fails
    async fn get_indicative_costs_edit(
        &self,
        request: &EditCostsRequest,
    ) -> Result<IndicativeCostsResponse, AppError>;

    /// Returns historical costs and charges for a date range
    ///
    /// # Arguments
    /// * `from` - Start date in ISO format (e.g., "2023-01-01")
    /// * `to` - End date in ISO format (e.g., "2023-12-31")
    ///
    /// # Returns
    /// * `Ok(CostsHistoryResponse)` - Historical costs data
    /// * `Err(AppError)` - If the request fails
    async fn get_costs_history(
        &self,
        from: &str,
        to: &str,
    ) -> Result<CostsHistoryResponse, AppError>;

    /// Returns a durable medium document for a quote reference
    ///
    /// # Arguments
    /// * `quote_reference` - The indicative quote reference
    ///
    /// # Returns
    /// * `Ok(DurableMediumResponse)` - The durable medium document
    /// * `Err(AppError)` - If the request fails
    async fn get_durable_medium(
        &self,
        quote_reference: &str,
    ) -> Result<DurableMediumResponse, AppError>;
}