trade-frontend/doc/visualizer-candles.md

Visualizer: świeczki + “brick stack” pod świecą

Timeframe (tf)

W visualizerze tf to długość świecy (bucket) przekazywana do API:

• 3s, 5s, 15s, 30s — mikro‑ruchy (dużo szumu, ale świetne do obserwacji mikrostruktury)
• 1m, 5m, 15m, 1h, 4h, 1d — klasyczne interwały

Kiedy ma to sens:

• 3s/5s: gdy chcesz widzieć “jak cena się buduje” w krótkich falach (np. po newsie / w dużej zmienności).
• 15s/30s: często najlepszy kompromis między szumem a czytelnością, jeżeli patrzysz na very-short-term.

Co pokazuje “brick stack” na dole

Pod każdą świecą rysujemy słupek złożony z “bricków” (małych segmentów) odpowiadających kolejnym krokom czasu wewnątrz świecy.

Kolory bricków:

• zielony = w tym kroku cena poszła w górę
• czerwony = w tym kroku cena poszła w dół
• niebieski = w tym kroku cena była stała (flat)

Wysokość bricków:

• zielony/czerwony: proporcjonalna do |Δprice| w danym kroku
• niebieski: stała (unit height)

Bricki są rozdzielone cienką czarną linią (1px), żeby było widać strukturę “krok po kroku”.

Jakie pola musi zwracać API

Endpoint GET /v1/chart zwraca w każdej świecy:

• flow: udziały czasu up/down/flat w całym buckecie (0..1)
• flowRows: tablica kierunków per krok czasu: -1 (down), 0 (flat), 1 (up)
• flowMoves: tablica “move magnitude” per krok czasu (wartości dodatnie; 0 jeśli flat)

To właśnie flowRows + flowMoves są używane do narysowania brick stacka.

Domyślny rynek

W visualizerze domyślnie ustawiony jest SOL-PERP.