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

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

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

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

Поведение в production

Это provider mutation с наибольшей фиксированной стоимостью. До запроса проверьте биржу, passphrase и разрешения. Обрабатывайте application/problem+json по стабильному code, сохраняйте correlation ID и не повторяйте mutation без идемпотентного сценария.