> ## Documentation Index
> Fetch the complete documentation index at: https://terminal.incrypto.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Structure

> Автоматическое обнаружение BOS (Break of Structure) и CHoCH (Change of Character) — ключевые концепции SMC.

Market Structure — фундаментальный индикатор Smart Money Concepts, который автоматически определяет свинг-точки и отмечает два важнейших структурных события: **Break of Structure (BOS)** и **Change of Character (CHoCH)**. Вместо ручного отслеживания максимумов и минимумов Cluster Terminal обнаруживает их алгоритмически и размечает каждый структурный пробой в реальном времени.

## Основные концепции

### Свинг-точки

Индикатор использует фрактальный алгоритм для обнаружения свинг-максимумов и свинг-минимумов. Свинг-максимум — это свеча, чей максимум выше максимумов окружающих свечей (контролируется параметром `swingLength`). Свинг-минимум — обратное.

Эти свинг-точки формируют скелет рыночной структуры — соединяя их, можно увидеть тренд.

### Break of Structure (BOS)

BOS происходит, когда цена пробивает предыдущую свинг-точку **в направлении текущего тренда**. Он подтверждает продолжение тренда:

* **Бычий BOS**: цена пробивает предыдущий свинг-максимум во время восходящего тренда. Более высокий максимум подтверждён.
* **Медвежий BOS**: цена пробивает предыдущий свинг-минимум во время нисходящего тренда. Более низкий минимум подтверждён.

### Change of Character (CHoCH)

CHoCH происходит, когда цена пробивает свинг-точку **против направления текущего тренда**. Это первый сигнал о возможном развороте тренда:

* **Бычий CHoCH**: во время нисходящего тренда цена пробивает предыдущий свинг-максимум. Последовательность более низких максимумов нарушена.
* **Медвежий CHoCH**: во время восходящего тренда цена пробивает предыдущий свинг-минимум. Последовательность более высоких минимумов нарушена.

<Tip>
  CHoCH — самое раннее предупреждение о возможном развороте тренда. Однако один CHoCH — это не подтверждение — дождитесь продолжения или конфлюэнции с индикаторами потока ордеров, прежде чем входить в разворотную сделку.
</Tip>

## Настройки обнаружения свингов

| Параметр           | Описание                                                                                                                                                                                                                      | По умолчанию |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **swingLength**    | Количество баров с каждой стороны свечи для подтверждения её как свинг-точки. Более высокие значения определяют только крупные свинги и снижают шум. Более низкие значения захватывают мелкие свинги для детальной структуры. | 5            |
| **breakDetection** | Как подтверждается структурный пробой: `close` или `wick`.                                                                                                                                                                    | close        |

### Режимы обнаружения пробоя

Параметр `breakDetection` существенно влияет на поведение сигналов:

| Mode      | Поведение                                                                                                                          | Применение                         |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| **close** | Структура пробита только когда свеча **закрывается** за свинг-уровнем. Более консервативный — избегает ложных пробоев от фитилей.  | Свинг-трейдинг, старшие таймфреймы |
| **wick**  | Структура пробита когда любая часть свечи (включая фитили) торгуется за свинг-уровнем. Более чувствительный — ловит пробои раньше. | Скальпинг, быстрые рынки           |

<Note>
  Использование режима `close` устраняет многие ложные пробои, где цена пробивает уровень фитилём, но закрывается обратно внутри. Это рекомендуемая настройка для большинства трейдеров.
</Note>

## Настройки отображения

### Внешний вид BOS

| Параметр         | Описание                                         | По умолчанию |
| ---------------- | ------------------------------------------------ | ------------ |
| **showBos**      | Включить метки и линии BOS на графике.           | true         |
| **bosLineColor** | Цвет горизонтальной линии BOS.                   | #3b82f6      |
| **bosLineWidth** | Толщина линии BOS в пикселях.                    | 1            |
| **bosLineStyle** | Стиль линии: `solid`, `dashed` или `dotted`.     | dashed       |
| **bosLabelShow** | Отображать текстовую метку «BOS» в точке пробоя. | true         |
| **bosLabelSize** | Размер шрифта метки BOS.                         | 11           |

### Внешний вид CHoCH

| Параметр           | Описание                                           | По умолчанию |
| ------------------ | -------------------------------------------------- | ------------ |
| **showChoch**      | Включить метки и линии CHoCH на графике.           | true         |
| **chochLineColor** | Цвет горизонтальной линии CHoCH.                   | #f59e0b      |
| **chochLineWidth** | Толщина линии CHoCH в пикселях.                    | 1            |
| **chochLineStyle** | Стиль линии: `solid`, `dashed` или `dotted`.       | dashed       |
| **chochLabelShow** | Отображать текстовую метку «CHoCH» в точке пробоя. | true         |
| **chochLabelSize** | Размер шрифта метки CHoCH.                         | 11           |

### Внешний вид свинг-точек

| Параметр            | Описание                                                       | По умолчанию |
| ------------------- | -------------------------------------------------------------- | ------------ |
| **showSwingPoints** | Отображать точки на обнаруженных свинг-максимумах и минимумах. | true         |
| **swingBullColor**  | Цвет точек свинг-минимумов (поддержка).                        | #22c55e      |
| **swingBearColor**  | Цвет точек свинг-максимумов (сопротивление).                   | #ef4444      |
| **swingDotSize**    | Диаметр точек свинг-точек в пикселях.                          | 6            |

### Отображение зигзага

| Параметр        | Описание                                                                                                                 | По умолчанию |
| --------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------ |
| **showZigzag**  | Нарисовать линию зигзага, соединяющую последовательные свинг-точки. Полезно для визуализации общего структурного потока. | false        |
| **zigzagColor** | Цвет линии зигзага.                                                                                                      | #9ca3af      |
| **zigzagWidth** | Толщина линии зигзага в пикселях.                                                                                        | 1            |

## Правила оповещений

Market Structure поддерживает следующие события оповещений:

| Event              | Срабатывает когда                                                                           |
| ------------------ | ------------------------------------------------------------------------------------------- |
| **bos\_bullish**   | Подтверждён бычий Break of Structure (цена пробивает свинг-максимум в восходящем тренде).   |
| **bos\_bearish**   | Подтверждён медвежий Break of Structure (цена пробивает свинг-минимум в нисходящем тренде). |
| **choch\_bullish** | Обнаружен бычий Change of Character (структура нисходящего тренда пробита вверх).           |
| **choch\_bearish** | Обнаружен медвежий Change of Character (структура восходящего тренда пробита вниз).         |

Настройте звуки и уведомления в глобальной панели настроек оповещений.

<Tip>
  Настройте оповещения только для событий CHoCH — они реже и более значимы, чем события BOS. Оповещение CHoCH даёт вам время подготовиться к потенциальной разворотной установке.
</Tip>

## Практическое применение

### Выбор Swing Length

Параметр `swingLength` определяет, насколько «крупными» будут обнаруженные свинг-точки:

| swingLength          | Эффект                                                                    | Лучше всего для            |
| -------------------- | ------------------------------------------------------------------------- | -------------------------- |
| **2–3**              | Захватывает мелкие свинги, много меток BOS/CHoCH. Шумно, но детально.     | Скальпинг на 1m–5m         |
| **5** (по умолчанию) | Сбалансированное обнаружение. Захватывает промежуточную структуру.        | Интрадей на 5m–1H          |
| **8–15**             | Только крупные свинг-точки. Меньше, но более значимые структурные пробои. | Свинг-трейдинг на 1H–Daily |

### Чтение структуры в контексте

Рыночная структура показывает, **кто контролирует ситуацию**:

* **Серия бычьих BOS** = покупатели контролируют, тренд восходящий. Ищите лонги на откатах.
* **Серия медвежьих BOS** = продавцы контролируют, тренд нисходящий. Ищите шорты на ралли.
* **Появляется CHoCH** = контроль смещается. Первый CHoCH — предупреждение, а не сигнал.
* **CHoCH + BOS в новом направлении** = тренд вероятно развернулся. Теперь ищите входы в направлении нового тренда.

### Конфлюэнция с другими индикаторами

* **Order Blocks**: CHoCH с последующим возвратом к ордер-блоку на уровне пробоя — классическая SMC-установка для входа.
* **FVG**: BOS часто создаёт FVG в процессе. FVG затем становится зоной повторного входа на откате.
* **Absorption Alpha**: поглощение на свинг-максимуме/минимуме, за которым следует CHoCH, подтверждает, что институционалы были активны на этом уровне.

### Распространённые ошибки

* **Торговля CHoCH в изоляции**: один CHoCH в сильном тренде часто является временным ложным пробоем. Дождитесь подтверждения.
* **Слишком низкий swing length в боковике**: очень низкий `swingLength` на боковом рынке создаёт постоянные переключения BOS/CHoCH. Увеличьте `swingLength` или сфокусируйтесь на структуре старшего таймфрейма.
* **Игнорирование мультитаймфреймной структуры**: CHoCH на 5-минутном графике бессмысленна, если структура 1H всё ещё сильно трендовая. Всегда проверяйте хотя бы один таймфрейм выше.

<Warning>
  Market Structure — это направленная система координат, а не самостоятельный сигнал для входа. Используйте её для определения тренда, затем тайминг входов обеспечивайте инструментами потока ордеров: дельта, имбалансы и поглощение.
</Warning>
