Files
dzentra_bot/docs/decisions/0008-private-account-first.md

87 lines
1.8 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.
# 0008 — Private API starts from Account Balance (Stable)
## Решение
Начать интеграцию private API с получения баланса аккаунта (`/api/v2/account`), а не с ордеров.
---
## Причины
### 1. Безопасность
- чтение баланса не изменяет состояние системы
- отсутствует риск случайной торговли
---
### 2. Простота отладки
Позволяет проверить:
- API ключ
- подпись (HMAC)
- headers
- timestamp
---
### 3. Быстрый UX результат
Пользователь сразу видит:
- баланс
- активы
---
### 4. База для следующих этапов
Баланс используется в:
- расчёте риска
- позициях
- ордерах
- журнале
---
## Реализация
Добавлено:
- ExchangePrivateClient
- balance_parser
- get_balance_summary()
- get_private_auth_health()
- экран 💼 Портфель
- статус авторизации в ⚙️ Система
---
## Последствия
### Положительные
✔ быстрый результат
✔ безопасная интеграция
✔ понятный UI
✔ устойчивая архитектура
---
### Отрицательные
- не покрывает сразу торговый сценарий
- требует следующего этапа (orders)
---
## Альтернативы
### Начать с ордеров
❌ отклонено:
- риск
- сложность
- сложнее отлаживать
---
## Статус
Stable
---
## Следующий шаг
➡ Stage 03.6 — Orders skeleton