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

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

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

Envelope возвращает метаданные аккаунтов и пагинацию. Limit до 50 стоит один кредит, 51–100 — два. Успешные платные ответы возвращают X-Credit-Cost и X-Credits-Remaining, чтобы usage можно было записать без дополнительного запроса.

Поведение в production

Portfolio ID — непрозрачный ресурс; каждая операция проверяет его принадлежность владельцу API-ключа. Обрабатывайте application/problem+json по стабильному code, сохраняйте correlation ID и не повторяйте mutation без идемпотентного сценария.