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

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

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

Результат содержит range, точки стоимости, показатели доходности и coverage для оценки качества числа. Успешные платные ответы возвращают X-Credit-Cost и X-Credits-Remaining, чтобы usage можно было записать без дополнительного запроса.

Поведение в production

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