`vpvr(rows, va, side, …)` — Volume Profile Visible Range

Canonical kind nội bộ: volume_profile. Verb khuyến nghị trong render v2: `vpvr` (alias legacy: volume_profile(...)).

VPVR kiểu TradingView: histogram ngang bám cạnh pane giá, tính từ toàn bộ OHLC đang hiển thị (hoặc lookback bar cuối nếu bạn giới hạn).

Story-style (khuyến nghị)

render:
  panel main:
    vpvr as "Visible Range Profile" with rows 64 and value area 70pct on right in cyan with opacity 14pct
    vpvr in lime and red with rows 48 and value area 68pct on right with opacity 30pct
    vpvr in lime and red and white with rows 48 on right with opacity 30pct

Modifier story:

Function call (truyền thống)

vpvr(rows: 64, va: 70pct, side: right, color: cyan, opacity: 14pct)
vpvr(rows: 48, lookback: 120, side: right, buy_color: lime, sell_color: red, poc_color: yellow, width_pct: 25, opacity: 30pct)

Tham số

Thuật toán

• Phân bổ volume theo High–Low từng bar (không bin theo close đơn).
• Buy / sell split: tỉ lệ theo vị trí close trong range H–L bar đó.
• POC — mức giá có tổng volume lớn nhất (đường ngang).
• Value area — mở rộng từ POC cho đến khi đạt va% tổng volume.

Pan / load tile (Candora)

• Khi pan trái merge tile lịch sử, engine recompute VP từ toàn bộ OHLC đã merge (một profile duy nhất mỗi panel+side).
• lookback: 0 (mặc định) = profile cover full visible session, không chỉ tile mới nhất.
• Chỉ dùng lookback: N khi bạn cố ý giới hạn N bar cuối (ví dụ profile 20 phiên gần nhất).

Render trên chart

• Layer QuantaDraw (foreground) trên pane giá.
• Bin trong value area sáng hơn; ngoài VA mờ hơn.
• Split mode: buy sát trục giá, sell phía trong (side right).

Ví dụ đầy đủ

strategy "VPVR Demo"
detect:
  c = market.close
render:
  panel main:
    line ema(c, 50) in amber
    vpvr as "VRVP" with rows 64 and value area 70pct on right in cyan with opacity 14pct
act:
  when true:
    signal(score: 0.1)