Портфель

Мій рахунок в Interactive Brokers як застосунок: скільки є, скільки заробив, як іде проти ринку, що лежить у портфелі й на що звернути увагу. Щодня записує вартість кожного активу на закритті біржі, тож можна порівняти будь-які дві дати й побачити, як ріс портфель. Ставиться на телефон і комп'ютер, працює без інтернету з останніми збереженими даними, має світлу й темну тему.

Адреса: https://portfel-mykyta.github.io/

Репозиторій лежить в окремій організації GitHub portfel-mykyta, тому в застосунку власна адреса: він ніде не перетинається з іншими сайтами акаунта й ставиться як окремий застосунок.

Як це влаштовано

IBKR (звіт Flex) ──► GitHub Actions щоранку ──► зашифрований data.enc.json у гілці data ──► застосунок
                      + ціни VOO (Yahoo)                                                          розшифровує
                      + курс НБУ                                                                  твоїм паролем

• Кожен запуск додає запис про останнє закриття біржі: вартість рахунку, кожного активу й вільних грошей. Записи накопичуються, тож історія не обрізається на році (сам звіт IBKR дає максимум 365 днів). Якщо оновлення кілька днів не працювало, пропущені закриття відновлюються: кількість паперів рахується за угодами, ціни беруться з Yahoo й прив'язуються до цін IBKR.
• Сайти GitHub Pages публічні, тому дані лежать лише в зашифрованому вигляді (AES-GCM, ключ з пароля через PBKDF2-SHA256, 600 000 ітерацій). Без пароля файл не прочитати.
• Пароль ніде не зберігається у відкритому вигляді: він є лише в секреті GitHub і в твоїй голові. На пристрої, якщо поставити галочку «Пам'ятати», лежить похідний ключ.
• Токен IBKR лежить тільки в секретах GitHub. У браузер він не потрапляє.
• Застосунок сам нічого не купує й не продає: лише читає звіт. Купувати допомагає сторінка «Купівля» в Claude (нижче), а відправляєш заявку завжди ти, в IBKR.

Налаштування, один раз (близько 10 хвилин)

1. Звіт Flex в IBKR

1. Зайди в Client Portal IBKR: Performance & Reports → Flex Queries (або Menu → Reporting → Flex Queries).
2. У блоці Activity Flex Query натисни +. Назва: Portfel.
3. У Sections відкрий по черзі ці розділи, у кожному натисни Select All і Save:
   • Net Asset Value (NAV) in Base: вартість рахунку по днях;
   • Open Positions: у параметрах обери Summary;
   • Trades: у параметрах обери Execution;
   • Cash Transactions: залиш усі типи (поповнення, дивіденди, податки) і рівень Detail;
   • Cash Report (не обов'язково, але корисно).
4. Delivery Configuration: Format XML, Period Last 365 Calendar Days.
5. General Configuration: Date Format yyyyMMdd, Time Format HHmmss, Date/Time Separator ; (semi-colon). Решту залиш як є.
6. Continue → Create. У списку звітів біля Portfel натисни значок інформації: там буде Query ID (число). Збережи його.

2. Токен Flex Web Service

1. На тій самій сторінці Flex Queries праворуч відкрий Flex Web Service Configuration.
2. Увімкни Flex Web Service Status і натисни Save. З'явиться Current Token.
3. Якщо створюєш новий токен: строк дії обери найдовший (до року), обмеження за IP не став, бо адреси GitHub щоразу інші.

3. Секрети в GitHub

Цей репозиторій (portfel-mykyta/portfel-mykyta.github.io) → Settings → Secrets and variables → Actions → New repository secret, три секрети:

Назва	Що вписати
IBKR_FLEX_TOKEN	токен з кроку 2
IBKR_FLEX_QUERY_ID	Query ID з кроку 1
INVEST_PASSWORD	пароль до застосунку, від 8 символів

Найпростіше лишити пароль, яким відкривається знімок зараз. Якщо хочеш свій, додай ще четвертий секрет INVEST_PASSWORD_OLD зі старим паролем: оновлення відкриє ним збережену історію й перешифрує її новим, а застосунок один раз попросить новий пароль. Після цього INVEST_PASSWORD_OLD можна видалити. Без нього оновлення зупиниться з поясненням: історію старшу за рік IBKR вдруге не віддасть, тож мовчки починати з нуля воно не буде.

4. Перший запуск

Actions → Портфель, оновити дані → Run workflow. За хвилину-дві з'явиться зелена галочка. Відкрий застосунок і натисни кнопку оновлення праворуч угорі.

Далі все працює саме: вівторок–субота, двічі зранку (за київським часом близько 7:17 і 12:47), бо звіт IBKR за торговий день з'являється вночі.

5. Історія з дня відкриття рахунку (один раз)

Звичайний запуск бере лише останні 365 днів. Щоб у застосунку був увесь час, запусти оновлення з галочкою: Actions → Портфель, оновити дані → Run workflow → «Дозавантажити попередні роки» → Run workflow. Оновлення попросить в IBKR звіти за попередні роки, по 365 днів назад, поки не дійде до дня відкриття рахунку, і допише їх в історію. Вартість активів на старі закриття відновлюється за угодами й цінами. Досить зробити це один раз: далі історія лише доповнюється.

Купівля: акції, фонди й облігації

У «Плані поповнення» задаєш суму, межу для однієї акції й бажану частку облігацій. План каже, що купити: фонд на S&P 500 (VOO, від $170 VUAA) і, якщо облігацій менше за задану частку, фонд облігацій уряду США (SGOV, від $170 IB01). Кнопка Купити відкриває сторінку «Купівля» в Claude: https://claude.ai/artifact/97fMDc1ZngDwhjdcGPJAss

• «Купівля» працює через конектор Interactive Brokers у Claude: бере живі ціни й позиції, рахує той самий план (plan-core.js) і одним натиском створює заявку (instruction) в IBKR. Паролів і ключів сторінка не бачить, а заявка нічого не купує, поки ти не відкриєш її в IBKR (Orders & Trades → AI Instructions) і не натиснеш Submit.
• Там же можна купити будь-яку акцію чи фонд американських бірж за тікером. Окремих облігацій конектор не підтримує, тож облігації тут купуються через фонди (SGOV, BIL, BND тощо).
• Чому не прямо з застосунку: сервери IBKR не приймають запитів із веб-сторінок (перевірено: відповіді api.ibkr.com не мають заголовків CORS), а торговий доступ для приватних клієнтів інакше йде лише через шлюз Client Portal на власному комп'ютері з входом щодня.
• Перший запуск «Купівлі» попросить дозволити їй доступ до конектора: це вікно Claude.

Сторінку збирає tools/kupivlia/build.py із шаблону tools/kupivlia/kupivlia.template.html і plan-core.js; опублікувати нову версію може Claude (той самий артефакт).

Як поставити застосунок

• iPhone, Safari: «Поділитися» → «На початковий екран».
• Android, Chrome: меню ⋮ → «Встановити застосунок» або «Додати на головний екран».
• Комп'ютер, Chrome чи Edge: кнопка «Встановити» в застосунку або значок у рядку адреси.

Якщо щось не так

• Червоний хрестик в Actions. Відкрий запуск і крок «Звіт IBKR і шифрування»: там написано українською, що не так (прострочений токен, неправильний Query ID тощо).
• Застосунок пише, що дані застаріли. Перевір вкладку Actions. Токен Flex діє до року: коли спливе, створи новий і онови секрет IBKR_FLEX_TOKEN.
• Щоденний запуск зник. GitHub вимикає розклад у публічних репозиторіях після 60 днів без змін. Кожен запуск сам себе вмикає знову, але якщо розклад усе ж вимкнувся, відкрий Actions і натисни Enable workflow.

Файли

Файл	Що робить
index.html, app.css, app.js, boot.js	сам застосунок, без збирання й залежностей
plan-core.js	правило поповнення, спільне для застосунку й «Купівлі» (node tools/plan-core.test.js)
tools/kupivlia/	сторінка «Купівля» для Claude: шаблон і збирання
sw.js	робота без інтернету
manifest.webmanifest, icon*.png, icon.svg	встановлення як застосунок
fonts/	шрифт Geologica (SIL Open Font License, див. fonts/OFL.txt)
tools/update_data.py	оновлення даних: Flex → шифрування
.github/workflows/update-data.yml	щоденний запуск оновлення

Перевірити оновлення на своєму комп'ютері зі збереженим XML-звітом, без мережі:

pip install cryptography
INVEST_PASSWORD=... python tools/update_data.py --xml statement.xml --offline --out data.enc.json