Quanta Docs

Tài liệu Quanta hoàn chỉnh cho Quant Studio

Khái niệmaiconcept/ai-codegen-pitfalls

Bẫy thường gặp khi AI / người mới gen Quanta

valuewhen+pivot+trendline; MA/RSI/MACD/ATR; safediv; struct; atr 4 args; không fill 0 cho plot. Từ khoá VN: đỉnh đáy, xu hướng, quá mua/bán, phá vỡ, dừng lỗ, sàng lọc.

1) `valuewhen` — đừng lấp pivot bằng `0` rồi vẽ `trendline`

Anti-pattern: valuewhen(ph > 0, bar.time, 0) — hầu hết bar có time=0 trong series, scalar cuối cho anchor chart sai → trendline không hiển thị hoặc sai.

Đúng: struct causal, cập nhật tại bar xác nhận (trễ R bar so với đỉnh — đó là lúc biết được pivot):

quanta
pk = lastpivothigh(market.high, L, R)
ph_h = pk.price
ph_t = pk.time
ph_i = pk.index
p1_h = pk.prev_price
p1_t = pk.prev_time

swinghigh nhìn R bar tương lai. Dùng nó trong when hoặc valuewhen(swinghigh(...), ...) là lookahead. Tín hiệu pk.isnew xuất hiện trễ R bar. Đây là thời điểm thực sự biết được pivot, không phải lỗi.

2) `p1 = ph_val[1]` không phải “pivot trước”

x[1] chỉ là shift 1 bar. Pivot trước là pk.prev_price, không phải pk.price[1].

3) Chia cho `dx` trên series

Dùng safediv(p2_h - p1_h, p2_i - p1_i, 0.0) thay vì / thuần.

4) Indicator nhiều đầu ra

macd(...) → .line, .signal, .hist. bbands → .upper, .mid, .lower. stoch → .k, .d. adx → .adx, …

5) `atr` cần 4 đối số

atr(market.high, market.low, market.close, n) — không viết atr(n).

6) `extend` cho trendline

Dùng bareword: extend_none, extend_left, extend_right, extend_both (inject sẵn → "none"|"left"|"right"|"both").

7) Biến chưa khai báo

❌ vol_color = gold when v+none_define > avg_vol else grey khi none_define chưa gán → QTA_E_UNDEFINED_NAME . Khai báo trong params: / detect: / logics: trước khi dùng.

#pitfalls#valuewhen#pivot#trendline#plot#llm
Trợ lý Quanta"Học nhanh hơn, hiệu quả hơn cùng AI"

Xin chào! Tôi là trợ lý học ngôn ngữ Quanta. Hỏi tôi về cú pháp, hàm, hoặc cách viết một chiến lược cụ thể (ví dụ: "Làm sao để xác định đỉnh đáy để vẽ trendline?").