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