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

1.8 KiB
Raw Permalink Blame History

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