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

GET /api/v1/portfolio. Агрегируйте все синхронизированные портфели владельца API-ключа в один текущий ответ. Передавайте персональный токен в X-API-Key и не размещайте его в браузерном коде или публичных логах.

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

Envelope содержит общую USD-стоимость, позиции, holdings с источниками и market-implied поля за 24 часа. Успешные платные ответы возвращают X-Credit-Cost и X-Credits-Remaining, чтобы usage можно было записать без дополнительного запроса.

Поведение в production

Поля за 24 часа — не transaction-aware lifetime P&L. Для истории используйте performance endpoint. Обрабатывайте application/problem+json по стабильному code, сохраняйте correlation ID и не повторяйте mutation без идемпотентного сценария.