Контракт запроса

GET /api/v1/portfolios/{portfolioId}/balances. Получите последние нормализованные балансы активов одного подключённого биржевого аккаунта. Передавайте персональный токен в X-API-Key и не размещайте его в браузерном коде или публичных логах.

Ответ и тарификация

Каждый элемент содержит актив, тип кошелька, доступное и заблокированное количество без раскрытия provider transport model. Успешные платные ответы возвращают X-Credit-Cost и X-Credits-Remaining, чтобы usage можно было записать без дополнительного запроса.

Поведение в production

Endpoint читает сохранённое синхронизированное состояние. Для свежих данных отдельно запускайте sync. Обрабатывайте application/problem+json по стабильному code, сохраняйте correlation ID и не повторяйте mutation без идемпотентного сценария.