Доступ к своим портфелям

Явное разрешение

Нужен персональный токен (csf_pat_…) со scope portfolio:read, а не ключ проекта (csf_live_…). Владелец выбирает конкретные портфели и подтверждает доступ только для чтения. Публичная ссылка на портфель, Steam ID или ID портфеля сами по себе такого разрешения не дают.

Токен можно отозвать; срок действия — не более 90 дней. Секрет показывается только при создании или ротации. Ротация сразу отключает предыдущий секрет, не продлевая срок действия. Храни токен в серверных секретах, не в промптах или браузерном коде.

Прочитать подключённый портфель

GET /v1/me/portfolios возвращает только выбранные для токена портфели, которые всё ещё принадлежат владельцу.
GET /v1/me/portfolios/{portfolio_id} возвращает настройки.
Добавь /holdings для позиций или /transactions для записей сделок.
Добавь /history?from=2026-09-01&to=2026-09-28 для доступных дневных снимков стоимости.

В списках meta.next_page передаётся без изменений в after. Не меняй фильтры между страницами. История и сделки поддерживают диапазон до 366 дней, по умолчанию — последние 31 день. Чужой, невыбранный и несуществующий портфели возвращают 404 для валидного персонального токена. Ключ проекта получает 403 на приватных методах.

Сохраняй смысл данных

Денежные поля — целые центы USD, даже если display_currency равна RUB.
unit_cost_cents позиции — закупочная стоимость одной единицы, не текущая рыночная цена. Null означает неизвестную стоимость; cost_estimated сохраняет признак оценки.
Сделки — записи владельца портфеля, не все продажи маркетплейса. Это не готовый расчёт реализованной прибыли.
Каждая точка истории сохраняет свой price_source. Null означает неизвестный источник старой точки; не заменяй его текущим маркетом портфеля.
Изменение общей стоимости — не инвестиционная доходность: на него влияют пополнения, выводы и состав инвентаря. Не называй такие снимки TWR или IRR.

Заметки, Steam-аккаунты и внешние идентификаторы интеграций исключены из ответов этих методов. Методы портфелей расходуют общую квоту аккаунта вместе с рыночными методами.