Files
dzentra_bot/docs/terminology.md

65 lines
4.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🧭 Терминология: биржа → UI бота → код
| 🏦 Термин биржи | 🤖 UI бота (как показываем) | 🧠 В коде (модель) | 💬 Комментарий |
|------------------------------|------------------------------------|--------------------------------|---------------|
| Купить | Купить (LONG) | `side = "BUY"` | Открытие long |
| Продать | Продать (SHORT) | `side = "SELL"` | Открытие short |
| Режим левереджа | 📈 Левередж | `trade_mode = "leverage"` | Основной режим |
| Режим торгов | 💱 Торги / Спот | `trade_mode = "spot"` | Без плеча |
| Купить сейчас | ⚡ MARKET | `order_type = "MARKET"` | Исполнение сразу |
| Купить когда цена = X | 🎯 LIMIT | `order_type = "LIMIT"` | Отложенный ордер |
| Цена | Цена | `price` | Только для LIMIT |
| Количество / Размер | Количество | `quantity` | Базовая величина |
| % от баланса | 5% / 10% / ... | `quantity` (расчёт) | UI-обёртка |
| Левередж | Плечо | `leverage` | Пока нет в модели |
| Доступно | Доступно | `available_balance` | из context |
| Ориентир цены (Last/Bid/Ask) | Ориентир цены | `reference_price` | для UI |
| Стоп-лосс | Стоп-лосс | `stop_loss` | будущий параметр |
| Тейк-профит | Тейк-профит | `take_profit` | будущий параметр |
| Сумма ордера | Сумма | `notional` | `price * quantity` |
| Мин. сумма | Мин. сумма | `min_notional` | правило биржи |
| Шаг количества | Шаг | `step_size` | правило |
| Мин. количество | Минимум | `min_qty` | правило |
| Черновик | Черновик | `draft` | статус |
| Подтвердить | Подтвердить | — | UI-действие |
---
## 🔥 Основные принципы
### 1. UI ≠ код
- UI: язык биржи (понятный пользователю)
- Код: строгая техническая модель
---
### 2. MARKET / LIMIT — это тип ордера
- не путать с режимом торговли (левередж / спот)
---
### 3. LONG / SHORT
- LONG = `BUY`
- SHORT = `SELL`
---
### 4. Текущий статус модели
✔ Уже есть:
- `side`
- `order_type`
- `quantity`
- `price`
🔜 Нужно добавить:
- `leverage`
- `stop_loss`
- `take_profit`
---
## 🧭 Итог
Пользователь видит **терминологию биржи**,
система работает на **нормализованной модели**.