# Облако Ишимоку

> Технический индикатор Ichimoku Cloud для определения тренда, поддержки и сопротивления в торговых стратегиях Veles.

**Облако Ишимоку (Ichimoku Cloud)** — технический индикатор, который помогает определить направление тренда, а также потенциальные зоны поддержки и сопротивления на рынке.

## Как работает Облако Ишимоку

Основная особенность индикатора — облако **Kumo**, которое строится между двумя линиями: **Senkou Span A** и **Senkou Span B**. Облако сдвигается вперёд на 26 периодов, отображая потенциальные зоны поддержки и сопротивления. Окрашивается в зависимости от положения линий относительно друг друга в зелёный (линия A над линией B) или красный (линия B над линией A) цвет.

Индикатор включает следующие компоненты:
1. **Tenkan-sen (Conversion Line)** — средняя цена за последние 9 периодов. Быстрая сигнальная линия, отражающая краткосрочный импульс.
2. **Kijun-sen (Base Line)** — средняя цена за последние 26 периодов. Медленная линия, показывающая среднесрочный тренд.
3. **Senkou Span A** — среднее значение Tenkan-sen и Kijun-sen, сдвинутое на 26 периодов вперёд. Формирует одну границу облака.
4. **Senkou Span B** — средняя цена за последние 52 периода, сдвинутая на 26 периодов вперёд. Формирует вторую границу облака.
5. **Chikou Span (Lagging Line)** — текущая цена закрытия, сдвинутая на 26 периодов назад. Обычно применяется для дополнительного подтверждения тренда и не используется в качестве отдельного сигнала.

**Формула Senkou Span A:**
> Span A = (Tenkan-sen + Kijun-sen) / 2, сдвиг +26 периодов

**Формула Senkou Span B:**
> Span B = (MAX High за 52 периода + MIN Low за 52 периода) / 2, сдвиг +26 периодов

:::note[Примечание]
Настройки индикатора по умолчанию:
Tenkan-sen — Length = 9, Kijun-sen — Length = 26, Senkou Span B — Length = 52, Chikou Span — Length = 26.
:::

## Ограничения

- Индикатор работает наиболее точно на **трендовых рынках**; в условиях бокового движения (флэта) возможны ложные сигналы.
- На волатильных рынках или при резких ценовых движениях сигналы могут поступать с задержкой.
- Для получения надёжных сигналов рекомендуется использовать таймфреймы от **1 часа и выше**.

## Применение в ботах Veles

На платформе доступно три типа сигналов по индикатору: **«Прорыв Kumo»**, **«Изменение цвета»** и **«Пересечение Tenkan и Kijun»**.

{x400|center}

### Облако Ишимоку: Прорыв Kumo

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

- **Сигнал на покупку (лонг)** или закрытие позиции в шорт: появляется, когда свеча закрывается над облаком.
- **Сигнал на продажу (шорт)** или закрытие позиции в лонг: появляется, когда свеча закрывается под облаком.

### Облако Ишимоку: Изменение цвета

Это опережающий сигнал, он свидетельствует о возможной скорой смене тренда.

- **Сигнал на покупку (лонг)** или закрытие позиции в шорт: линия **Senkou Span A** пересекает линию **Senkou Span B** снизу вверх (облако меняет цвет с красного на зелёный).
- **Сигнал на продажу (шорт)** или закрытие позиции в лонг: линия **Senkou Span A** пересекает линию **Senkou Span B** сверху вниз (облако меняет цвет с зелёного на красный).

:::caution[Важно]
Расчёт сигналов всегда учитывает сдвиг линий **Senkou Span** на 26 периодов вперёд — это критически важно для корректной интерпретации сигналов от фильтра «Изменение цвета». Визуально сигнал отстаёт на 26 свечей от смены цвета.
:::

### Облако Ишимоку: Пересечение Tenkan и Kijun

Пересечение данных линий применяется, как индикатор направления ценового импульса.

- **Сигнал на покупку (лонг)** или закрытие позиции в шорт: появляется, когда линия **Tenkan-sen** пересекает линию **Kijun-sen** снизу вверх («золотой крест»).
- **Сигнал на продажу (шорт)** или закрытие позиции в лонг: появляется, когда линия **Tenkan-sen** пересекает линию **Kijun-sen** сверху вниз («мёртвый крест»).

## Итог

Используйте **Облако Ишимоку: Прорыв Kumo**, если:
- Нужен чёткий сигнал при пробое ключевого уровня сопротивления/поддержки.
- Необходимо определить направление текущего тренда.

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

Используйте **Облако Ишимоку: Пересечение Tenkan и Kijun**, если:
- Нужно войти и выйти из сделки при смене направления импульса.

**Итоговая рекомендация:** комбинируйте все три варианта сигналов или дополняйте гибкими компонентами (Span A, Span B, Lagging Span, Tenkan-sen, Kijun-sen) для построения многоуровневых стратегий с высокой точностью фильтрации.

Проверяйте работу индикатора с помощью [бэктестов](https://help.veles.finance/ru/platform/components/backtests/) перед запуском бота.

---

## Облако Ишимоку и Гибкие Индикаторы

Помимо готовых вариантов сигналов, на платформе доступны четыре компонента Ichimoku Cloud как отдельные индикаторы для гибкой настройки алгоритмов.

### Senkou Span A

**Senkou Span A** — быстрая граница облака, рассчитывается как среднее значение линий Tenkan-sen и Kijun-sen, сдвинутое на указанное количество периодов вперёд.
- **Использование:** определяет динамическую поддержку (при восходящем тренде) или сопротивление (при нисходящем).
- **Пример применения:** пересечение ценой уровня Span A — сигнал смены краткосрочного направления. Можно использовать как триггер для входа или выхода из позиции.

### Senkou Span B

**Senkou Span B** — медленная граница облака, рассчитывается как среднее значение максимума и минимума цен за указанный период, сдвинутое на определённое количество свечей вперёд.
- **Использование:** более сильный уровень поддержки/сопротивления по сравнению со Span A. Широкое облако между Span A и Span B означает сильный тренд.
- **Пример применения:** нахождение цены выше/ниже Span B подтверждает сохранение тренда; пробой Span B — сигнал его окончания.

### Tenkan-sen (Conversion Line)

**Tenkan-sen (Conversion Line)** — быстрая сигнальная линия, отражающая краткосрочный тренд.

### Kijun-sen (Base Line)

**Kijun-sen (Base Line)** — средняя цена за указанное количество периодов. Медленная линия, показывающая среднесрочный тренд.
- **Использование:** Tenkan и Kijun можно применять как трендовые линии, а их взаимопересечение использовать как сигнал смены направления импульса.
- **Пример применения:** цена закрывается выше линий — сигнал устойчивого тренда. Их пересечения могут свидетельствовать о смене настроений на рынке.

:::tip[Совет]
Если вы только начинаете работать с индикатором, попробуйте сочетание **«Облако Ишимоку: Прорыв Kumo»** и **«Пересечение Tenkan и Kijun»** — так вы сможете отслеживать и смену тренда, и смену краткосрочного импульса.
:::

## Применение в ботах Veles (гибкие индикаторы)

Доступные настройки:

- Период - длина линии индикатора. Диапазон: 5–100. Значение по умолчанию зависит от компонента: Conversion Line — 9, Base Line — 26, Leading Span B — 52, Lagging Span — 26. Не применяется к сигнальным типам (Прорыв Kumo, Изменение цвета, Пересечение TK).
- Интервал - таймфрейм свечей.
- Метод - тип расчета. По закрытию бара (только на выбранном интервале), либо по минуте (раз в минуту для любого интервала).
- Сдвиг - смещение запрашиваемого значения индикатора на заданное количество свечей назад.
- Направление - «Buy» (покупка) или «Sell» (продажа). Прямая или обратная логика фильтра (только для сигналов).