sqa 0.0.31 → 0.0.37
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +104 -0
- data/CLAUDE.md +21 -0
- data/README.md +60 -32
- data/Rakefile +52 -10
- data/docs/IMPROVEMENT_PLAN.md +531 -0
- data/docs/advanced/index.md +1 -13
- data/docs/api/dataframe.md +0 -1
- data/docs/api/index.md +547 -61
- data/docs/api-reference/alphavantageapi.md +1057 -0
- data/docs/api-reference/apierror.md +31 -0
- data/docs/api-reference/index.md +221 -0
- data/docs/api-reference/notimplemented.md +27 -0
- data/docs/api-reference/sqa.md +267 -0
- data/docs/api-reference/sqa_backtest.md +137 -0
- data/docs/api-reference/sqa_backtest_results.md +530 -0
- data/docs/api-reference/sqa_badparametererror.md +13 -0
- data/docs/api-reference/sqa_config.md +538 -0
- data/docs/api-reference/sqa_configurationerror.md +13 -0
- data/docs/api-reference/sqa_datafetcherror.md +56 -0
- data/docs/api-reference/sqa_dataframe.md +752 -0
- data/docs/api-reference/sqa_dataframe_alphavantage.md +30 -0
- data/docs/api-reference/sqa_dataframe_data.md +325 -0
- data/docs/api-reference/sqa_dataframe_yahoofinance.md +25 -0
- data/docs/api-reference/sqa_ensemble.md +413 -0
- data/docs/api-reference/sqa_fpop.md +211 -0
- data/docs/api-reference/sqa_geneticprogram.md +325 -0
- data/docs/api-reference/sqa_geneticprogram_individual.md +114 -0
- data/docs/api-reference/sqa_marketregime.md +212 -0
- data/docs/api-reference/sqa_multitimeframe.md +227 -0
- data/docs/api-reference/sqa_patternmatcher.md +195 -0
- data/docs/api-reference/sqa_pluginmanager.md +55 -0
- data/docs/api-reference/sqa_portfolio.md +455 -0
- data/docs/api-reference/sqa_portfolio_position.md +220 -0
- data/docs/api-reference/sqa_portfolio_trade.md +332 -0
- data/docs/api-reference/sqa_portfoliooptimizer.md +248 -0
- data/docs/api-reference/sqa_riskmanager.md +388 -0
- data/docs/api-reference/sqa_seasonalanalyzer.md +121 -0
- data/docs/api-reference/sqa_sectoranalyzer.md +163 -0
- data/docs/api-reference/sqa_stock.md +649 -0
- data/docs/api-reference/sqa_strategy.md +178 -0
- data/docs/api-reference/sqa_strategy_bollingerbands.md +26 -0
- data/docs/api-reference/sqa_strategy_common.md +29 -0
- data/docs/api-reference/sqa_strategy_consensus.md +129 -0
- data/docs/api-reference/sqa_strategy_ema.md +41 -0
- data/docs/api-reference/sqa_strategy_kbs.md +154 -0
- data/docs/api-reference/sqa_strategy_macd.md +26 -0
- data/docs/api-reference/sqa_strategy_mp.md +41 -0
- data/docs/api-reference/sqa_strategy_mr.md +41 -0
- data/docs/api-reference/sqa_strategy_random.md +41 -0
- data/docs/api-reference/sqa_strategy_rsi.md +41 -0
- data/docs/api-reference/sqa_strategy_sma.md +41 -0
- data/docs/api-reference/sqa_strategy_stochastic.md +26 -0
- data/docs/api-reference/sqa_strategy_volumebreakout.md +26 -0
- data/docs/api-reference/sqa_strategygenerator.md +298 -0
- data/docs/api-reference/sqa_strategygenerator_pattern.md +264 -0
- data/docs/api-reference/sqa_strategygenerator_patterncontext.md +326 -0
- data/docs/api-reference/sqa_strategygenerator_profitablepoint.md +424 -0
- data/docs/api-reference/sqa_stream.md +256 -0
- data/docs/api-reference/sqa_ticker.md +175 -0
- data/docs/api-reference/string.md +135 -0
- data/docs/assets/images/advanced-workflow.svg +89 -0
- data/docs/assets/images/architecture.svg +107 -0
- data/docs/assets/images/data-flow.svg +138 -0
- data/docs/assets/images/getting-started-workflow.svg +88 -0
- data/docs/assets/images/sqa.jpg +0 -0
- data/docs/assets/images/strategy-flow.svg +78 -0
- data/docs/assets/images/system-architecture.svg +150 -0
- data/docs/concepts/index.md +292 -27
- data/docs/data_frame.md +0 -1
- data/docs/getting-started/index.md +1 -30
- data/docs/getting-started/installation.md +2 -2
- data/docs/getting-started/quick-start.md +4 -4
- data/docs/index.md +26 -25
- data/docs/llms.txt +109 -0
- data/docs/strategies/bollinger-bands.md +1 -1
- data/docs/strategies/kbs.md +15 -14
- data/docs/strategies/rsi.md +1 -1
- data/docs/strategy.md +381 -3
- data/docs/terms_of_use.md +1 -1
- data/examples/README.md +10 -0
- data/lib/api/alpha_vantage_api.rb +3 -7
- data/lib/sqa/config.rb +109 -28
- data/lib/sqa/data_frame/alpha_vantage.rb +13 -3
- data/lib/sqa/data_frame/data.rb +13 -1
- data/lib/sqa/data_frame.rb +189 -41
- data/lib/sqa/errors.rb +79 -17
- data/lib/sqa/indicator.rb +17 -4
- data/lib/sqa/init.rb +70 -15
- data/lib/sqa/pattern_matcher.rb +4 -4
- data/lib/sqa/portfolio.rb +1 -1
- data/lib/sqa/sector_analyzer.rb +3 -11
- data/lib/sqa/stock.rb +236 -20
- data/lib/sqa/strategy.rb +62 -4
- data/lib/sqa/ticker.rb +107 -42
- data/lib/sqa/version.rb +1 -1
- data/lib/sqa.rb +16 -8
- data/mkdocs.yml +68 -117
- metadata +90 -36
- data/docs/README.md +0 -43
- data/docs/alpha_vantage_technical_indicators.md +0 -62
- data/docs/average_true_range.md +0 -9
- data/docs/bollinger_bands.md +0 -15
- data/docs/candlestick_pattern_recognizer.md +0 -4
- data/docs/donchian_channel.md +0 -5
- data/docs/double_top_bottom_pattern.md +0 -3
- data/docs/exponential_moving_average.md +0 -19
- data/docs/fibonacci_retracement.md +0 -30
- data/docs/head_and_shoulders_pattern.md +0 -3
- data/docs/market_profile.md +0 -4
- data/docs/momentum.md +0 -19
- data/docs/moving_average_convergence_divergence.md +0 -23
- data/docs/peaks_and_valleys.md +0 -11
- data/docs/relative_strength_index.md +0 -6
- data/docs/simple_moving_average.md +0 -8
- data/docs/stochastic_oscillator.md +0 -4
- data/docs/ta_lib.md +0 -160
- data/docs/true_range.md +0 -12
- data/docs/true_strength_index.md +0 -46
- data/docs/weighted_moving_average.md +0 -48
- data/examples/sinatra_app/Gemfile +0 -22
- data/examples/sinatra_app/QUICKSTART.md +0 -159
- data/examples/sinatra_app/README.md +0 -461
- data/examples/sinatra_app/app.rb +0 -344
- data/examples/sinatra_app/config.ru +0 -5
- data/examples/sinatra_app/public/css/style.css +0 -659
- data/examples/sinatra_app/public/js/app.js +0 -107
- data/examples/sinatra_app/views/analyze.erb +0 -306
- data/examples/sinatra_app/views/backtest.erb +0 -325
- data/examples/sinatra_app/views/dashboard.erb +0 -419
- data/examples/sinatra_app/views/error.erb +0 -58
- data/examples/sinatra_app/views/index.erb +0 -118
- data/examples/sinatra_app/views/layout.erb +0 -61
- data/examples/sinatra_app/views/portfolio.erb +0 -43
data/examples/sinatra_app/app.rb
DELETED
|
@@ -1,344 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env ruby
|
|
2
|
-
# frozen_string_literal: true
|
|
3
|
-
|
|
4
|
-
require 'sinatra'
|
|
5
|
-
require 'sinatra/json'
|
|
6
|
-
require 'json'
|
|
7
|
-
|
|
8
|
-
# Add SQA lib to load path
|
|
9
|
-
$LOAD_PATH.unshift(File.expand_path('../../lib', __dir__))
|
|
10
|
-
|
|
11
|
-
require 'sqa'
|
|
12
|
-
|
|
13
|
-
# Initialize SQA
|
|
14
|
-
SQA.init
|
|
15
|
-
|
|
16
|
-
# Configure Sinatra
|
|
17
|
-
set :port, 4567
|
|
18
|
-
set :bind, '0.0.0.0'
|
|
19
|
-
set :public_folder, File.dirname(__FILE__) + '/public'
|
|
20
|
-
set :views, File.dirname(__FILE__) + '/views'
|
|
21
|
-
|
|
22
|
-
# Enable sessions for flash messages
|
|
23
|
-
enable :sessions
|
|
24
|
-
|
|
25
|
-
# Helpers
|
|
26
|
-
helpers do
|
|
27
|
-
def format_percent(value)
|
|
28
|
-
sprintf("%.2f%%", value)
|
|
29
|
-
end
|
|
30
|
-
|
|
31
|
-
def format_currency(value)
|
|
32
|
-
sprintf("$%.2f", value)
|
|
33
|
-
end
|
|
34
|
-
|
|
35
|
-
def format_number(value)
|
|
36
|
-
value.to_s.reverse.gsub(/(\d{3})(?=\d)/, '\\1,').reverse
|
|
37
|
-
end
|
|
38
|
-
end
|
|
39
|
-
|
|
40
|
-
# Routes
|
|
41
|
-
|
|
42
|
-
# Home / Dashboard
|
|
43
|
-
get '/' do
|
|
44
|
-
erb :index
|
|
45
|
-
end
|
|
46
|
-
|
|
47
|
-
# Dashboard for specific ticker
|
|
48
|
-
get '/dashboard/:ticker' do
|
|
49
|
-
ticker = params[:ticker].upcase
|
|
50
|
-
|
|
51
|
-
begin
|
|
52
|
-
@stock = SQA::Stock.new(ticker: ticker)
|
|
53
|
-
@ticker = ticker
|
|
54
|
-
erb :dashboard
|
|
55
|
-
rescue => e
|
|
56
|
-
@error = "Failed to load data for #{ticker}: #{e.message}"
|
|
57
|
-
erb :error
|
|
58
|
-
end
|
|
59
|
-
end
|
|
60
|
-
|
|
61
|
-
# Analysis page
|
|
62
|
-
get '/analyze/:ticker' do
|
|
63
|
-
ticker = params[:ticker].upcase
|
|
64
|
-
|
|
65
|
-
begin
|
|
66
|
-
@stock = SQA::Stock.new(ticker: ticker)
|
|
67
|
-
@ticker = ticker
|
|
68
|
-
erb :analyze
|
|
69
|
-
rescue => e
|
|
70
|
-
@error = "Failed to load data for #{ticker}: #{e.message}"
|
|
71
|
-
erb :error
|
|
72
|
-
end
|
|
73
|
-
end
|
|
74
|
-
|
|
75
|
-
# Backtest page
|
|
76
|
-
get '/backtest/:ticker' do
|
|
77
|
-
ticker = params[:ticker].upcase
|
|
78
|
-
|
|
79
|
-
begin
|
|
80
|
-
@stock = SQA::Stock.new(ticker: ticker)
|
|
81
|
-
@ticker = ticker
|
|
82
|
-
erb :backtest
|
|
83
|
-
rescue => e
|
|
84
|
-
@error = "Failed to load data for #{ticker}: #{e.message}"
|
|
85
|
-
erb :error
|
|
86
|
-
end
|
|
87
|
-
end
|
|
88
|
-
|
|
89
|
-
# Portfolio optimizer
|
|
90
|
-
get '/portfolio' do
|
|
91
|
-
erb :portfolio
|
|
92
|
-
end
|
|
93
|
-
|
|
94
|
-
# API Endpoints
|
|
95
|
-
|
|
96
|
-
# Get stock data
|
|
97
|
-
get '/api/stock/:ticker' do
|
|
98
|
-
content_type :json
|
|
99
|
-
|
|
100
|
-
ticker = params[:ticker].upcase
|
|
101
|
-
|
|
102
|
-
begin
|
|
103
|
-
stock = SQA::Stock.new(ticker: ticker)
|
|
104
|
-
df = stock.df
|
|
105
|
-
|
|
106
|
-
# Get price data
|
|
107
|
-
dates = df["date"].to_a.map(&:to_s)
|
|
108
|
-
opens = df["open_price"].to_a
|
|
109
|
-
highs = df["high_price"].to_a
|
|
110
|
-
lows = df["low_price"].to_a
|
|
111
|
-
closes = df["adj_close_price"].to_a
|
|
112
|
-
volumes = df["volume"].to_a
|
|
113
|
-
|
|
114
|
-
# Calculate basic stats
|
|
115
|
-
current_price = closes.last
|
|
116
|
-
prev_price = closes[-2]
|
|
117
|
-
change = current_price - prev_price
|
|
118
|
-
change_pct = (change / prev_price) * 100
|
|
119
|
-
|
|
120
|
-
{
|
|
121
|
-
ticker: ticker,
|
|
122
|
-
current_price: current_price,
|
|
123
|
-
change: change,
|
|
124
|
-
change_percent: change_pct,
|
|
125
|
-
high_52w: closes.last(252).max,
|
|
126
|
-
low_52w: closes.last(252).min,
|
|
127
|
-
dates: dates,
|
|
128
|
-
open: opens,
|
|
129
|
-
high: highs,
|
|
130
|
-
low: lows,
|
|
131
|
-
close: closes,
|
|
132
|
-
volume: volumes
|
|
133
|
-
}.to_json
|
|
134
|
-
rescue => e
|
|
135
|
-
status 500
|
|
136
|
-
{ error: e.message }.to_json
|
|
137
|
-
end
|
|
138
|
-
end
|
|
139
|
-
|
|
140
|
-
# Get technical indicators
|
|
141
|
-
get '/api/indicators/:ticker' do
|
|
142
|
-
content_type :json
|
|
143
|
-
|
|
144
|
-
ticker = params[:ticker].upcase
|
|
145
|
-
|
|
146
|
-
begin
|
|
147
|
-
stock = SQA::Stock.new(ticker: ticker)
|
|
148
|
-
df = stock.df
|
|
149
|
-
|
|
150
|
-
prices = df["adj_close_price"].to_a
|
|
151
|
-
highs = df["high_price"].to_a
|
|
152
|
-
lows = df["low_price"].to_a
|
|
153
|
-
dates = df["date"].to_a.map(&:to_s)
|
|
154
|
-
|
|
155
|
-
# Calculate indicators
|
|
156
|
-
rsi = SQAI.rsi(prices, period: 14)
|
|
157
|
-
macd_result = SQAI.macd(prices)
|
|
158
|
-
bb_result = SQAI.bbands(prices)
|
|
159
|
-
sma_20 = SQAI.sma(prices, period: 20)
|
|
160
|
-
sma_50 = SQAI.sma(prices, period: 50)
|
|
161
|
-
ema_20 = SQAI.ema(prices, period: 20)
|
|
162
|
-
|
|
163
|
-
{
|
|
164
|
-
dates: dates,
|
|
165
|
-
rsi: rsi,
|
|
166
|
-
macd: macd_result[0], # MACD line
|
|
167
|
-
macd_signal: macd_result[1], # Signal line
|
|
168
|
-
macd_hist: macd_result[2], # Histogram
|
|
169
|
-
bb_upper: bb_result[0],
|
|
170
|
-
bb_middle: bb_result[1],
|
|
171
|
-
bb_lower: bb_result[2],
|
|
172
|
-
sma_20: sma_20,
|
|
173
|
-
sma_50: sma_50,
|
|
174
|
-
ema_20: ema_20
|
|
175
|
-
}.to_json
|
|
176
|
-
rescue => e
|
|
177
|
-
status 500
|
|
178
|
-
{ error: e.message }.to_json
|
|
179
|
-
end
|
|
180
|
-
end
|
|
181
|
-
|
|
182
|
-
# Run backtest
|
|
183
|
-
post '/api/backtest/:ticker' do
|
|
184
|
-
content_type :json
|
|
185
|
-
|
|
186
|
-
ticker = params[:ticker].upcase
|
|
187
|
-
strategy_name = params[:strategy] || 'RSI'
|
|
188
|
-
|
|
189
|
-
begin
|
|
190
|
-
stock = SQA::Stock.new(ticker: ticker)
|
|
191
|
-
|
|
192
|
-
# Resolve strategy
|
|
193
|
-
strategy = case strategy_name.upcase
|
|
194
|
-
when 'RSI' then SQA::Strategy::RSI
|
|
195
|
-
when 'SMA' then SQA::Strategy::SMA
|
|
196
|
-
when 'EMA' then SQA::Strategy::EMA
|
|
197
|
-
when 'MACD' then SQA::Strategy::MACD
|
|
198
|
-
when 'BOLLINGERBANDS' then SQA::Strategy::BollingerBands
|
|
199
|
-
when 'KBS' then SQA::Strategy::KBS
|
|
200
|
-
else SQA::Strategy::RSI
|
|
201
|
-
end
|
|
202
|
-
|
|
203
|
-
# Run backtest
|
|
204
|
-
backtest = SQA::Backtest.new(
|
|
205
|
-
stock: stock,
|
|
206
|
-
strategy: strategy,
|
|
207
|
-
initial_capital: 10_000.0,
|
|
208
|
-
commission: 1.0
|
|
209
|
-
)
|
|
210
|
-
|
|
211
|
-
results = backtest.run
|
|
212
|
-
|
|
213
|
-
{
|
|
214
|
-
total_return: results.total_return,
|
|
215
|
-
annualized_return: results.annualized_return,
|
|
216
|
-
sharpe_ratio: results.sharpe_ratio,
|
|
217
|
-
max_drawdown: results.max_drawdown,
|
|
218
|
-
win_rate: results.win_rate,
|
|
219
|
-
total_trades: results.total_trades,
|
|
220
|
-
profit_factor: results.profit_factor,
|
|
221
|
-
avg_win: results.avg_win,
|
|
222
|
-
avg_loss: results.avg_loss
|
|
223
|
-
}.to_json
|
|
224
|
-
rescue => e
|
|
225
|
-
status 500
|
|
226
|
-
{ error: e.message }.to_json
|
|
227
|
-
end
|
|
228
|
-
end
|
|
229
|
-
|
|
230
|
-
# Run market analysis
|
|
231
|
-
get '/api/analyze/:ticker' do
|
|
232
|
-
content_type :json
|
|
233
|
-
|
|
234
|
-
ticker = params[:ticker].upcase
|
|
235
|
-
|
|
236
|
-
begin
|
|
237
|
-
stock = SQA::Stock.new(ticker: ticker)
|
|
238
|
-
prices = stock.df["adj_close_price"].to_a
|
|
239
|
-
|
|
240
|
-
# Market regime
|
|
241
|
-
regime = SQA::MarketRegime.detect(stock)
|
|
242
|
-
|
|
243
|
-
# Seasonal analysis
|
|
244
|
-
seasonal = SQA::SeasonalAnalyzer.analyze(stock)
|
|
245
|
-
|
|
246
|
-
# FPOP analysis
|
|
247
|
-
fpop_data = SQA::FPOP.fpl_analysis(prices, fpop: 10)
|
|
248
|
-
recent_fpop = fpop_data.last(10).map do |f|
|
|
249
|
-
{
|
|
250
|
-
direction: f[:direction],
|
|
251
|
-
magnitude: f[:magnitude],
|
|
252
|
-
risk: f[:risk],
|
|
253
|
-
interpretation: f[:interpretation]
|
|
254
|
-
}
|
|
255
|
-
end
|
|
256
|
-
|
|
257
|
-
# Risk metrics
|
|
258
|
-
returns = prices.each_cons(2).map { |a, b| (b - a) / a }
|
|
259
|
-
var_95 = SQA::RiskManager.var(returns, confidence: 0.95)
|
|
260
|
-
sharpe = SQA::RiskManager.sharpe_ratio(returns)
|
|
261
|
-
max_dd = SQA::RiskManager.max_drawdown(prices)
|
|
262
|
-
|
|
263
|
-
{
|
|
264
|
-
regime: {
|
|
265
|
-
type: regime[:type],
|
|
266
|
-
volatility: regime[:volatility],
|
|
267
|
-
strength: regime[:strength],
|
|
268
|
-
trend: regime[:trend]
|
|
269
|
-
},
|
|
270
|
-
seasonal: {
|
|
271
|
-
best_months: seasonal[:best_months],
|
|
272
|
-
worst_months: seasonal[:worst_months],
|
|
273
|
-
best_quarters: seasonal[:best_quarters],
|
|
274
|
-
has_pattern: seasonal[:has_seasonal_pattern]
|
|
275
|
-
},
|
|
276
|
-
fpop: recent_fpop,
|
|
277
|
-
risk: {
|
|
278
|
-
var_95: var_95,
|
|
279
|
-
sharpe_ratio: sharpe,
|
|
280
|
-
max_drawdown: max_dd[:max_drawdown]
|
|
281
|
-
}
|
|
282
|
-
}.to_json
|
|
283
|
-
rescue => e
|
|
284
|
-
status 500
|
|
285
|
-
{ error: e.message }.to_json
|
|
286
|
-
end
|
|
287
|
-
end
|
|
288
|
-
|
|
289
|
-
# Compare strategies
|
|
290
|
-
post '/api/compare/:ticker' do
|
|
291
|
-
content_type :json
|
|
292
|
-
|
|
293
|
-
ticker = params[:ticker].upcase
|
|
294
|
-
|
|
295
|
-
begin
|
|
296
|
-
stock = SQA::Stock.new(ticker: ticker)
|
|
297
|
-
|
|
298
|
-
strategies = {
|
|
299
|
-
'RSI' => SQA::Strategy::RSI,
|
|
300
|
-
'SMA' => SQA::Strategy::SMA,
|
|
301
|
-
'EMA' => SQA::Strategy::EMA,
|
|
302
|
-
'MACD' => SQA::Strategy::MACD,
|
|
303
|
-
'BollingerBands' => SQA::Strategy::BollingerBands
|
|
304
|
-
}
|
|
305
|
-
|
|
306
|
-
results = strategies.map do |name, strategy_class|
|
|
307
|
-
backtest = SQA::Backtest.new(
|
|
308
|
-
stock: stock,
|
|
309
|
-
strategy: strategy_class,
|
|
310
|
-
initial_capital: 10_000.0,
|
|
311
|
-
commission: 1.0
|
|
312
|
-
)
|
|
313
|
-
|
|
314
|
-
result = backtest.run
|
|
315
|
-
|
|
316
|
-
{
|
|
317
|
-
strategy: name,
|
|
318
|
-
return: result.total_return,
|
|
319
|
-
sharpe: result.sharpe_ratio,
|
|
320
|
-
drawdown: result.max_drawdown,
|
|
321
|
-
win_rate: result.win_rate,
|
|
322
|
-
trades: result.total_trades
|
|
323
|
-
}
|
|
324
|
-
rescue => e
|
|
325
|
-
nil
|
|
326
|
-
end.compact
|
|
327
|
-
|
|
328
|
-
results.sort_by! { |r| -r[:return] }
|
|
329
|
-
results.to_json
|
|
330
|
-
rescue => e
|
|
331
|
-
status 500
|
|
332
|
-
{ error: e.message }.to_json
|
|
333
|
-
end
|
|
334
|
-
end
|
|
335
|
-
|
|
336
|
-
# Start server
|
|
337
|
-
if __FILE__ == $0
|
|
338
|
-
puts "=" * 60
|
|
339
|
-
puts "SQA Web Application"
|
|
340
|
-
puts "=" * 60
|
|
341
|
-
puts "Starting server on http://localhost:4567"
|
|
342
|
-
puts "Press Ctrl+C to stop"
|
|
343
|
-
puts "=" * 60
|
|
344
|
-
end
|