chapaty 1.1.0

High-performance backtesting and financial simulation framework for trading strategies and reinforcement learning agents. Async-first, Gym-like API in Rust.
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262

// This file is @generated by prost-build.
/// DataBroker identifies the upstream system/provider that produced the data.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
#[repr(i32)]
pub enum DataBroker {
    /// Default/unknown broker.
    Unspecified = 0,
    /// Binance exchange.
    Binance = 1,
    /// NinjaTrader platform.
    NinjaTrader = 2,
    /// Investing.com data source.
    InvestingCom = 3,
}
impl DataBroker {
    /// String value of the enum field names used in the ProtoBuf definition.
    ///
    /// The values are not transformed in any way and thus are considered stable
    /// (if the ProtoBuf definition does not change) and safe for programmatic use.
    pub fn as_str_name(&self) -> &'static str {
        match self {
            Self::Unspecified => "DATA_BROKER_UNSPECIFIED",
            Self::Binance => "DATA_BROKER_BINANCE",
            Self::NinjaTrader => "DATA_BROKER_NINJA_TRADER",
            Self::InvestingCom => "DATA_BROKER_INVESTING_COM",
        }
    }
    /// Creates an enum from field names used in the ProtoBuf definition.
    pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
        match value {
            "DATA_BROKER_UNSPECIFIED" => Some(Self::Unspecified),
            "DATA_BROKER_BINANCE" => Some(Self::Binance),
            "DATA_BROKER_NINJA_TRADER" => Some(Self::NinjaTrader),
            "DATA_BROKER_INVESTING_COM" => Some(Self::InvestingCom),
            _ => None,
        }
    }
}
/// Batch of economic calendar events.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct EconomicCalendarBatch {
    #[prost(message, repeated, tag = "1")]
    pub events: ::prost::alloc::vec::Vec<EconomicCalendarEvent>,
}
/// Single economic calendar event (e.g., Non-Farm Payrolls, CPI release).
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct EconomicCalendarEvent {
    /// UTC timestamp of the event.
    /// Converted from local time zone, adjusted for daylight saving time if applicable.
    #[prost(message, optional, tag = "1")]
    pub event_timestamp: ::core::option::Option<::prost_types::Timestamp>,
    /// Data source (e.g., "investingcom", "fred")
    #[prost(string, tag = "2")]
    pub data_source: ::prost::alloc::string::String,
    /// Event category from the data source (e.g., investing.com classification).
    #[prost(string, tag = "3")]
    pub category: ::prost::alloc::string::String,
    /// Classified event type identifier (e.g., "NFP", "CPI", "FOMC").
    /// Empty string if classification was not performed or failed.
    /// Classification may be derived from:
    ///
    /// * Deterministic text rules (news_type_source = "rule")
    /// * ML/NLP models (news_type_source = "ml" or "nlp")
    /// * Manual curation (news_type_source = "manual")
    #[prost(string, tag = "4")]
    pub news_type: ::prost::alloc::string::String,
    /// Confidence score for news_type classification (0.0 to 1.0).
    /// Null if news_type is empty or unclassified.
    /// Deterministic rules typically use 1.0.
    /// ML/NLP models provide calibrated probability scores.
    #[prost(double, optional, tag = "5")]
    pub news_type_confidence: ::core::option::Option<f64>,
    /// Method used to derive news_type classification.
    /// Common values:
    /// "manual" - Manually labeled or curated by a human
    /// "rule"   - Deterministic text-matching or heuristic rules
    /// "ml"     - Machine learning classifier (e.g., BigQuery ML)
    /// "nlp"    - Natural language processing pipeline or LLM
    /// Empty string if news_type was not classified.
    #[prost(string, tag = "6")]
    pub news_type_source: ::prost::alloc::string::String,
    /// Reporting periodicity of the indicator.
    /// Describes the time period over which the metric is measured or compared.
    /// Common values:
    /// "mom" - Month-over-Month (e.g., monthly CPI growth)
    /// "qoq" - Quarter-over-Quarter (e.g., quarterly GDP growth)
    /// "yoy" - Year-over-Year (e.g., annual inflation rate)
    /// Empty string for non-recurring or irregular events.
    #[prost(string, tag = "7")]
    pub periodicity: ::prost::alloc::string::String,
    /// Full descriptive name of the event (e.g., "Non-Farm Payrolls Report").
    #[prost(string, tag = "8")]
    pub news_name: ::prost::alloc::string::String,
    /// ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "JP").
    /// "EZ" is commonly used for Euro Zone.
    #[prost(string, tag = "9")]
    pub country_code: ::prost::alloc::string::String,
    /// ISO 4217 currency code (e.g., "USD", "EUR", "GBP").
    #[prost(string, tag = "10")]
    pub currency_code: ::prost::alloc::string::String,
    /// Importance level of the event.
    /// Typical scale: 1 = Low, 2 = Medium, 3 = High
    /// Zero if importance is not assigned or unknown.
    #[prost(int32, tag = "11")]
    pub importance: i32,
    /// Actual reported value of the economic indicator.
    /// Null if not yet released or not applicable.
    #[prost(double, optional, tag = "12")]
    pub actual: ::core::option::Option<f64>,
    /// Forecasted/expected value before release.
    /// Null if no forecast was published.
    #[prost(double, optional, tag = "13")]
    pub forecast: ::core::option::Option<f64>,
    /// Previously reported value (from prior release period).
    /// Null if not applicable or unavailable.
    #[prost(double, optional, tag = "14")]
    pub previous: ::core::option::Option<f64>,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct OhlcvFutureBatch {
    #[prost(message, repeated, tag = "1")]
    pub events: ::prost::alloc::vec::Vec<OhlcvFutureEvent>,
}
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct OhlcvFutureEvent {
    #[prost(message, optional, tag = "1")]
    pub open_timestamp: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(double, tag = "2")]
    pub open: f64,
    #[prost(double, tag = "3")]
    pub high: f64,
    #[prost(double, tag = "4")]
    pub low: f64,
    #[prost(double, tag = "5")]
    pub close: f64,
    #[prost(double, tag = "6")]
    pub volume: f64,
    #[prost(message, optional, tag = "7")]
    pub close_timestamp: ::core::option::Option<::prost_types::Timestamp>,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct OhlcvSpotBatch {
    #[prost(message, repeated, tag = "1")]
    pub events: ::prost::alloc::vec::Vec<OhlcvSpotEvent>,
}
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct OhlcvSpotEvent {
    #[prost(message, optional, tag = "1")]
    pub open_timestamp: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(double, tag = "2")]
    pub open: f64,
    #[prost(double, tag = "3")]
    pub high: f64,
    #[prost(double, tag = "4")]
    pub low: f64,
    #[prost(double, tag = "5")]
    pub close: f64,
    #[prost(double, tag = "6")]
    pub volume: f64,
    #[prost(message, optional, tag = "7")]
    pub close_timestamp: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(double, tag = "8")]
    pub quote_asset_volume: f64,
    #[prost(int64, tag = "9")]
    pub number_of_trades: i64,
    #[prost(double, tag = "10")]
    pub taker_buy_base_asset_volume: f64,
    #[prost(double, tag = "11")]
    pub taker_buy_quote_asset_volume: f64,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct TpoFutureBatch {
    #[prost(message, repeated, tag = "1")]
    pub events: ::prost::alloc::vec::Vec<TpoFutureEvent>,
}
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct TpoFutureEvent {
    #[prost(message, optional, tag = "1")]
    pub window_start: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(message, optional, tag = "2")]
    pub window_end: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(double, tag = "3")]
    pub price_bin_start: f64,
    #[prost(double, tag = "4")]
    pub price_bin_end: f64,
    #[prost(int64, tag = "5")]
    pub time_slot_count: i64,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct TpoSpotBatch {
    #[prost(message, repeated, tag = "1")]
    pub events: ::prost::alloc::vec::Vec<TpoSpotEvent>,
}
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct TpoSpotEvent {
    #[prost(message, optional, tag = "1")]
    pub window_start: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(message, optional, tag = "2")]
    pub window_end: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(double, tag = "3")]
    pub price_bin_start: f64,
    #[prost(double, tag = "4")]
    pub price_bin_end: f64,
    #[prost(int64, tag = "5")]
    pub time_slot_count: i64,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct TradesSpotBatch {
    #[prost(message, repeated, tag = "4")]
    pub events: ::prost::alloc::vec::Vec<TradesSpotEvent>,
}
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct TradesSpotEvent {
    #[prost(int64, tag = "1")]
    pub trade_id: i64,
    #[prost(double, tag = "2")]
    pub price: f64,
    #[prost(double, tag = "3")]
    pub quantity: f64,
    #[prost(double, tag = "4")]
    pub quote_quantity: f64,
    #[prost(message, optional, tag = "5")]
    pub trade_timestamp: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(bool, tag = "6")]
    pub is_buyer_maker: bool,
    #[prost(bool, tag = "7")]
    pub is_best_match: bool,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct VolumeProfileSpotBatch {
    #[prost(message, repeated, tag = "1")]
    pub events: ::prost::alloc::vec::Vec<VolumeProfileSpotEvent>,
}
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct VolumeProfileSpotEvent {
    #[prost(message, optional, tag = "1")]
    pub window_start: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(message, optional, tag = "2")]
    pub window_end: ::core::option::Option<::prost_types::Timestamp>,
    #[prost(double, tag = "3")]
    pub price_bin_start: f64,
    #[prost(double, tag = "4")]
    pub price_bin_end: f64,
    #[prost(double, tag = "5")]
    pub base_volume: f64,
    #[prost(double, tag = "6")]
    pub taker_buy_base_volume: f64,
    #[prost(double, tag = "7")]
    pub taker_sell_base_volume: f64,
    #[prost(double, tag = "8")]
    pub quote_volume: f64,
    #[prost(double, tag = "9")]
    pub taker_buy_quote_volume: f64,
    #[prost(double, tag = "10")]
    pub taker_sell_quote_volume: f64,
    #[prost(int64, tag = "11")]
    pub number_of_trades: i64,
    #[prost(int64, tag = "12")]
    pub number_of_buy_trades: i64,
    #[prost(int64, tag = "13")]
    pub number_of_sell_trades: i64,
}