Skip to main content

cripsy_binary_api/domain/
asset.rs

1//! Activos, clases y estado de mercado.
2
3use serde::{Deserialize, Serialize};
4
5#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
6pub enum AssetClass {
7    Forex,
8    Crypto,
9    Cfd,
10    Digital,
11    Turbo,
12    Binary,
13    /// Grupo blitz del inicializador v3 (duraciones en segundos).
14    Blitz,
15    Commodity,
16    Etf,
17    Index,
18}
19
20#[derive(Debug, Clone, Copy, PartialEq, Serialize, Deserialize)]
21pub struct ScheduleWindow {
22    /// Epoch segundos: apertura del mercado.
23    pub open: i64,
24    /// Epoch segundos: cierre del mercado.
25    pub close: i64,
26}
27
28impl ScheduleWindow {
29    /// ¿Está `now` dentro de la ventana?
30    pub fn contains(&self, now: i64) -> bool {
31        self.open <= now && now < self.close
32    }
33}
34
35#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
36pub struct Asset {
37    /// Símbolo legible, p. ej. `EURUSD` o `EURUSD-OTC`.
38    pub symbol: String,
39    /// Nombre legible del bróker.
40    pub name: String,
41    pub class: AssetClass,
42    /// ID numérico del bróker (obligatorio en IQ Option).
43    pub opcode: u32,
44    /// Estado de mercado informado por el bróker.
45    pub status: MarketStatus,
46    /// Payout en porcentaje (100 - comisión), si el bróker lo informa.
47    pub payout_percent: Option<f64>,
48    /// Sector declarado por el bróker (p. ej. `forex`, `energy`).
49    pub sector: Option<String>,
50    /// Horario declarado por el bróker, si lo expone.
51    pub schedule: Option<Vec<ScheduleWindow>>,
52    /// Metadatos específicos del tipo de opción (blitz: rollovers, minmax...).
53    pub extras: Option<AssetExtras>,
54}
55
56/// Metadatos adicionales por tipo de opción (verificados en vivo). Expone lo
57/// que el bróker publica en el inicializador y que ninguna API capturaba.
58#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
59pub struct AssetExtras {
60    /// Duraciones admitidas en segundos (blitz).
61    pub expiration_times_secs: Option<Vec<u64>>,
62    pub rollovers: Option<Vec<super::operation::RolloverParams>>,
63    pub min_amount: Option<f64>,
64    pub max_amount: Option<f64>,
65    /// Proveedor del precio: `OTC` o mercado real.
66    pub provider: Option<String>,
67    /// Feed de precio que alimenta el activo (p. ej. `front.exchange_eurusdotc`).
68    pub exchange: Option<String>,
69    /// Antigüedad del activo (epoch segundos).
70    pub start_time: Option<i64>,
71    /// Ventana (s) en la que el bróker admite venta anticipada (buyback).
72    pub buyback_deadtime: Option<u32>,
73    /// Margen (s) antes del cierre en que la orden deja de aceptarse.
74    pub deadtime: Option<u32>,
75    /// ¿El activo admite venta anticipada?
76    pub is_buyback: Option<bool>,
77    /// ¿Participa en el ranking social de la plataforma?
78    pub top_traders_enabled: Option<bool>,
79    /// Decimales de precio del activo.
80    pub precision: Option<u32>,
81    /// Monto mínimo/máximo de operación declarados por el bróker.
82    pub minimal_bet: Option<f64>,
83    pub maximal_bet: Option<f64>,
84}
85
86impl Asset {
87    /// ¿El mercado de este activo está abierto según la ventana horaria?
88    pub fn is_open_by_schedule(&self, now: i64) -> bool {
89        self.schedule
90            .as_ref()
91            .map(|windows| windows.iter().any(|w| w.contains(now)))
92            .unwrap_or(false)
93    }
94}
95
96#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
97pub enum MarketStatus {
98    Open,
99    Closed,
100    Suspended,
101}
102
103#[cfg(test)]
104mod tests {
105    use super::*;
106
107    #[test]
108    fn schedule_window_contiene_now() {
109        let w = ScheduleWindow {
110            open: 100,
111            close: 200,
112        };
113        assert!(w.contains(100));
114        assert!(w.contains(150));
115        assert!(!w.contains(200));
116        assert!(!w.contains(99));
117    }
118
119    #[test]
120    fn asset_is_open_by_schedule() {
121        let asset = Asset {
122            symbol: "EURUSD".into(),
123            name: "EUR/USD".into(),
124            class: AssetClass::Forex,
125            opcode: 1,
126            status: MarketStatus::Open,
127            payout_percent: Some(80.0),
128            sector: Some("forex".into()),
129            schedule: Some(vec![ScheduleWindow { open: 0, close: 10 }]),
130            extras: None,
131        };
132        assert!(asset.is_open_by_schedule(5));
133        assert!(!asset.is_open_by_schedule(50));
134        assert!(!Asset {
135            schedule: None,
136            ..asset
137        }
138        .is_open_by_schedule(5));
139    }
140}