calculate_compound_interest

Рассчитывает будущую стоимость при инвестировании основной суммы (единовременно) и ежемесячной суммы накоплений с ежемесячным сложным процентом. Универсальный инструмент, подходит не только для NISA, но и для обычных симуляций инвестиций и срочных вкладов.

複利計算（一括 + 月次積立）

Рассчитывает будущую стоимость при инвестировании основной суммы (единовременно) и ежемесячной суммы накоплений с ежемесячным сложным процентом. Универсальный инструмент, подходит не только для NISA, но и для обычных симуляций инвестиций и срочных вкладов.

Параметры

principalnumber
一括投入する元本（円）。例: 1000000
monthlyContributionnumber
毎月の積立額（円）。一括だけなら 0
annualRatenumberобязательный
想定年利（%表記。例: 3 = 3%/年）
yearsnumberобязательный
運用年数（小数可。例: 0.5 = 半年、10.5 = 10年6ヶ月）

calculate_required_monthly

Целевая сумма, текущие сбережения, предполагаемая годовая ставка и срок накопления — из этих данных вычисляется ежемесячный взнос, необходимый для достижения цели. Инструмент отвечает на вопрос: «Сколько нужно откладывать в месяц, чтобы через N лет накопить X рублей?»

必要月額逆算

Целевая сумма, текущие сбережения, предполагаемая годовая ставка и срок накопления — из этих данных вычисляется ежемесячный взнос, необходимый для достижения цели. Инструмент отвечает на вопрос: «Сколько нужно откладывать в месяц, чтобы через N лет накопить X рублей?»

Параметры

targetAmountnumberобязательный
達成したい目標金額（円）。例: 20000000
currentSavingsnumber
現在の投資資産（円。複利運用される）
annualRatenumberобязательный
想定年利（%表記）
yearsintegerобязательный
積立期間（年）

get_analyst_consensus

Получает аналитические рейтинги отдельных акций (от «решительная покупка» до «решительная продажа»), целевые цены (средняя/максимум/минимум) и помесячную разбивку рекомендаций (Yahoo Finance). Американские акции покрыты хорошо, по японским акциям и ETF данные часто отсутствуют. Это сводные значения, а не инвестиционная рекомендация.

アナリストコンセンサスの取得

Получает аналитические рейтинги отдельных акций (от «решительная покупка» до «решительная продажа»), целевые цены (средняя/максимум/минимум) и помесячную разбивку рекомендаций (Yahoo Finance). Американские акции покрыты хорошо, по японским акциям и ETF данные часто отсутствуют. Это сводные значения, а не инвестиционная рекомендация.

Параметры

symbolstringобязательный
Yahoo Finance ティッカー。例: NVDA / AAPL / 7203.T（トヨタ）。指数や暗号資産は対象外

get_central_bank_speakers

Инструмент возвращает **предстоящие** выступления и запланированные речи чиновников центральных банков. Получает бесплатный календарь ForexFactory и отдаёт только речевые события (члены совета управляющих ФРС, президенты региональных банков ФРС, Банк Японии, ЕЦБ, Банк Англии и т.д.) в порядке возрастания даты. Для выступающих от ФРС США (FOMC) подставляет **role** (например, президент Dallas Fed) и **votingMember** (наличие права голоса) из списка на текущий год. Выступления голосующих членов сильнее влияют на рыночные ожидания, поэтому их важность (importance) повышена (председатель = ★★★ / члены с правом голоса = ★★ и выше). Назначение: когда в сводке по рынку просят «сегодняшние выступления ключевых лиц» или «спикеров ФРС на этой неделе». Для макроэкономических индикаторов и дат заседаний по денежно-кредитной политике используйте отдельный инструмент `get_economic_events_today` (этот инструмент предназначен **только** для выступлений).【Важно】Зависит от стороннего бесплатного фида (еженедельный календарь ForexFactory от faireconomy.media). Если фид по какой-то причине недоступен, ошибки записываются в массив sources как error, а данные, которые удалось получить, возвращаются (частичный успех). Охват — текущая неделя ForexFactory (пн-вс). Если при range="week" дата выходит за пределы недели и захватывает следующую, данные могут отсутствовать, пока та неделя не появится в фиде. Время выступлений и сам факт их проведения могут меняться в последний момент. Возвращаемая мета-информация содержит только объективные значения, рыночная интерпретация не добавляется (это ответственность вызывающей LLM). Список ФРС — редакция 2026 года (последнее обновление 2026-05-27). Право голоса ротируется ежегодно в январе.

中銀高官の発言・講演スケジュール（ライブ取得）

Инструмент возвращает **предстоящие** выступления и запланированные речи чиновников центральных банков. Получает бесплатный календарь ForexFactory и отдаёт только речевые события (члены совета управляющих ФРС, президенты региональных банков ФРС, Банк Японии, ЕЦБ, Банк Англии и т.д.) в порядке возрастания даты. Для выступающих от ФРС США (FOMC) подставляет **role** (например, президент Dallas Fed) и **votingMember** (наличие права голоса) из списка на текущий год. Выступления голосующих членов сильнее влияют на рыночные ожидания, поэтому их важность (importance) повышена (председатель = ★★★ / члены с правом голоса = ★★ и выше). Назначение: когда в сводке по рынку просят «сегодняшние выступления ключевых лиц» или «спикеров ФРС на этой неделе». Для макроэкономических индикаторов и дат заседаний по денежно-кредитной политике используйте отдельный инструмент `get_economic_events_today` (этот инструмент предназначен **только** для выступлений).【Важно】Зависит от стороннего бесплатного фида (еженедельный календарь ForexFactory от faireconomy.media). Если фид по какой-то причине недоступен, ошибки записываются в массив sources как error, а данные, которые удалось получить, возвращаются (частичный успех). Охват — текущая неделя ForexFactory (пн-вс). Если при range="week" дата выходит за пределы недели и захватывает следующую, данные могут отсутствовать, пока та неделя не появится в фиде. Время выступлений и сам факт их проведения могут меняться в последний момент. Возвращаемая мета-информация содержит только объективные значения, рыночная интерпретация не добавляется (это ответственность вызывающей LLM). Список ФРС — редакция 2026 года (последнее обновление 2026-05-27). Право голоса ротируется ежегодно в январе.

Параметры

rangeenum
期間: today=本日のみ / week=今日含む 7 日間。既定 today。『明日』『今週』『週末』など今日を超える時間軸を含むときは week を指定すること。
todayweek
countriesstring[]
国で絞り込み: US=米 Fed / JP=日銀 / EU=ECB / GB=BOE / CN=中国 / OTHER=その他中銀（カナダ・豪・NZ・スイス等）。未指定で全件

get_dividend_history

Получает историю дивидендов за последние N лет по отдельным акциям или ETF и суммы за каждый календарный год (Yahoo Finance). Используется как первичная информация при рассмотрении дивидендных акций в рамках растущего инвестиционного лимита NISA. По акциям с нулевыми дивидендами возвращается пустой массив dividends. Это не инвестиционная консультация.

配当履歴の取得

Получает историю дивидендов за последние N лет по отдельным акциям или ETF и суммы за каждый календарный год (Yahoo Finance). Используется как первичная информация при рассмотрении дивидендных акций в рамках растущего инвестиционного лимита NISA. По акциям с нулевыми дивидендами возвращается пустой массив dividends. Это не инвестиционная консультация.

Параметры

symbolstringобязательный
Yahoo Finance ティッカー。例: KO（コカ・コーラ）/ JNJ（J&J）/ 8306.T（三菱 UFJ）/ VYM（高配当 ETF）
yearsenum
取得する年数。1 / 3 / 5 / 10 のいずれか。既定 5
13510

get_economic_events_today

Возвращает главные экономические события дня (или недели): заседания FOMC и Банка Японии, отчёты по занятости в США, CPI, ВВП, PMI Китая и другие макроэкономические индикаторы. Периодические события (симпозиум в Джексон-Хоуле и т.п.) срабатывают на каждый день периода при запросе today. Данные — вручную отобранное расписание от оператора lit-forge на полгода. Выступления и речи представителей центральных банков получайте через отдельный инструмент `get_central_bank_speakers` (живая подписка). [Важно при использовании] По умолчанию range=today возвращает только события текущего дня. Если вопрос пользователя выходит за рамки сегодня («завтра», «на этой неделе», «на выходных», «следующий индикатор»), явно указывайте range="week". Даже если только что получили данные через today, как только речь заходит о будущем, перезапрашивайте с week. [Начиная с версии 0.9.0] Четыре подкатегории — встречи лидеров, визиты высоких лиц, международные саммиты, выборы в ключевых странах и геополитические риски — перенесены в `get_geopolitical_calendar` (подтверждённое расписание). Текущая геополитическая обстановка — в `get_geopolitical_pulse` (реальная лента новостей). Когда нужна геополитика, используйте эти инструменты. Аргумент category="geopolitical" у этого инструмента оставлен для обратной совместимости, но результаты будут почти пустыми.

本日・今週の経済イベント

Возвращает главные экономические события дня (или недели): заседания FOMC и Банка Японии, отчёты по занятости в США, CPI, ВВП, PMI Китая и другие макроэкономические индикаторы. Периодические события (симпозиум в Джексон-Хоуле и т.п.) срабатывают на каждый день периода при запросе today. Данные — вручную отобранное расписание от оператора lit-forge на полгода. Выступления и речи представителей центральных банков получайте через отдельный инструмент `get_central_bank_speakers` (живая подписка). [Важно при использовании] По умолчанию range=today возвращает только события текущего дня. Если вопрос пользователя выходит за рамки сегодня («завтра», «на этой неделе», «на выходных», «следующий индикатор»), явно указывайте range="week". Даже если только что получили данные через today, как только речь заходит о будущем, перезапрашивайте с week. [Начиная с версии 0.9.0] Четыре подкатегории — встречи лидеров, визиты высоких лиц, международные саммиты, выборы в ключевых странах и геополитические риски — перенесены в `get_geopolitical_calendar` (подтверждённое расписание). Текущая геополитическая обстановка — в `get_geopolitical_pulse` (реальная лента новостей). Когда нужна геополитика, используйте эти инструменты. Аргумент category="geopolitical" у этого инструмента оставлен для обратной совместимости, но результаты будут почти пустыми.

Параметры

rangeenum
期間: today=本日のみ / week=今日含む 7 日間。既定 today。翌日以降のイベント（『明日』『今週』『週末』『次の指標』等）を含めて答える必要があるときは必ず week を指定すること。
todayweek
minImportanceenum
最低重要度フィルタ: 1=★以上 / 2=★★以上 / 3=★★★のみ。既定 1
123
categorystring[]
カテゴリ絞り込み: macro=マクロ経済指標 / geopolitical=要人訪問・首脳会談 / policy=選挙・予算・サミット。未指定で全カテゴリ

get_economic_release_pulse

Инструмент, который **реально получает официальные календари релизов** и возвращает запланированные на сегодня-неделю публикации экономических показателей. Параллельно загружает официальные расписания BEA (Бюро экономического анализа США), ФРБ Нью-Йорка, ФРС, Бюро переписи населения США, Кабинета министров Японии и Банка Японии и возвращает их с фильтрацией по стране и периоду. **Отличие от `get_economic_events_today`**: `get_economic_events_today` — это ручная курация с верификацией по первичным источникам (в основном ★★★, обновление раз в полгода). Из-за узкого охвата в ней есть «дыры» в полноте — некоторые события выпадают. Этот инструмент закрывает эти дыры, **дополняя** данные за счёт реального получения официальных календарей. При составлении рыночного обзора используйте оба инструмента вместе. **Текущий охват (v0.20.0)**: - **BEA** (ВВП США / личные доходы и расходы [PCE] / торговый баланс / прибыль корпораций) - **ФРБ Нью-Йорка** (индекс деловой активности в производстве Empire State) - **ФРС** (промышленное производство G.17) - **BLS** (занятость, CPI, PPI — через официальное расписание PFEI Белого дома) - **DOL/ETA** (еженедельные заявки на пособие по безработице в США — еженедельно, каждый четверг в 08:30 ET) - **ForexFactory live** (JOLTS, предварительные PMI обрабатывающей и сферы услуг, ISM обрабатывающей и непроизводственной сферы, потребительское доверие [Conference Board / Мичиганский университет], ADP employment — живёт через еженедельный XML-календарь faireconomy. Динамизирует показатели, не попавшие в PFEI или ранее получаемые только вручную) - **Бюро переписи населения США** (оптовые запасы, розничные запасы, предварительные данные по торговому балансу товаров — отчёт Advance Economic Indicators, ежемесячно в 08:30 ET. Живёт через официальный List View, автоматически подхватывая данные на следующий год) - **Кабинет министров Японии** (предварительные данные по квартальному ВВП) - **Банк Японии** (заседания по денежно-кредитной политике / основные мнения / «Танкан» / протоколы заседаний) **Статистическое бюро Министерства внутренних дел и коммуникаций Японии (ИПЦ Японии) и FOMC** запланированы к добавлению в следующем цикле и пока в этот инструмент не входят. **Примечания по использованию**: Сбои при загрузке отдельных адаптеров фиксируются как ошибки в массиве `sources`; результаты от остальных адаптеров всё равно возвращаются (частичный успех). Результаты кэшируются на 6 часов. Каждое событие снабжается ссылкой на первоисточник (`sourceUrl`).

経済指標リリース予定（公式機関カレンダーリアルタイム取得）

Инструмент, который **реально получает официальные календари релизов** и возвращает запланированные на сегодня-неделю публикации экономических показателей. Параллельно загружает официальные расписания BEA (Бюро экономического анализа США), ФРБ Нью-Йорка, ФРС, Бюро переписи населения США, Кабинета министров Японии и Банка Японии и возвращает их с фильтрацией по стране и периоду. **Отличие от `get_economic_events_today`**: `get_economic_events_today` — это ручная курация с верификацией по первичным источникам (в основном ★★★, обновление раз в полгода). Из-за узкого охвата в ней есть «дыры» в полноте — некоторые события выпадают. Этот инструмент закрывает эти дыры, **дополняя** данные за счёт реального получения официальных календарей. При составлении рыночного обзора используйте оба инструмента вместе. **Текущий охват (v0.20.0)**: - **BEA** (ВВП США / личные доходы и расходы [PCE] / торговый баланс / прибыль корпораций) - **ФРБ Нью-Йорка** (индекс деловой активности в производстве Empire State) - **ФРС** (промышленное производство G.17) - **BLS** (занятость, CPI, PPI — через официальное расписание PFEI Белого дома) - **DOL/ETA** (еженедельные заявки на пособие по безработице в США — еженедельно, каждый четверг в 08:30 ET) - **ForexFactory live** (JOLTS, предварительные PMI обрабатывающей и сферы услуг, ISM обрабатывающей и непроизводственной сферы, потребительское доверие [Conference Board / Мичиганский университет], ADP employment — живёт через еженедельный XML-календарь faireconomy. Динамизирует показатели, не попавшие в PFEI или ранее получаемые только вручную) - **Бюро переписи населения США** (оптовые запасы, розничные запасы, предварительные данные по торговому балансу товаров — отчёт Advance Economic Indicators, ежемесячно в 08:30 ET. Живёт через официальный List View, автоматически подхватывая данные на следующий год) - **Кабинет министров Японии** (предварительные данные по квартальному ВВП) - **Банк Японии** (заседания по денежно-кредитной политике / основные мнения / «Танкан» / протоколы заседаний) **Статистическое бюро Министерства внутренних дел и коммуникаций Японии (ИПЦ Японии) и FOMC** запланированы к добавлению в следующем цикле и пока в этот инструмент не входят. **Примечания по использованию**: Сбои при загрузке отдельных адаптеров фиксируются как ошибки в массиве `sources`; результаты от остальных адаптеров всё равно возвращаются (частичный успех). Результаты кэшируются на 6 часов. Каждое событие снабжается ссылкой на первоисточник (`sourceUrl`).

Параметры

rangeenum
today=本日のみ / week=今日含む 7 日間。既定 today
todayweek
countryenum
国コード絞り込み: US=米国 / JP=日本 / EU / GB / CN。未指定で全件。現行カバーは US（BEA・NY 連銀・FRB・BLS〔PFEI〕・DOL/ETA・ForexFactory〔JOLTS/PMI速報/ISM/消費者信頼感/ADP〕・センサス局）と JP（内閣府・日銀）のみ
USJPEUGBCN

get_geopolitical_calendar

**Инструмент для работы ТОЛЬКО с утверждённым официальным расписанием.** Возвращает 4 подкатегории: встречи на высшем уровне и визиты высокопоставленных лиц (bilateral), международные саммиты G7/G20/IMF/APEC/BRICS/NATO (summit), национальные выборы в крупных странах (election), официальные даты геополитических рисков (введение санкций, сроки действия договоров и т.п., risk). К каждому событию прилагаются: влияние на рынок (market implications — валюты, акции, облигации, сырьё), участники, ссылка на первоисточник. Данные вручную отбираются оператором lit-forge из первоисточников (официальные сайты правительства Японии, международных организаций, частные сводки). **Статические данные, обновляемые PR раз в полгода** — содержат только подтверждённые официальные даты (события, требующие субъективной оценки, не регистрируются). **Важно**: этот инструмент — «календарь», **он не учитывает текущие геополитические риски (обострения конфликтов, внезапные переговоры, неожиданные санкции, сценарии блокады и т.п.)**. Если нужно узнать геополитическую обстановку прямо сейчас, используйте другой инструмент `get_geopolitical_pulse`. **Примечание по использованию**: по умолчанию range=week. Чтобы заглянуть дальше, укажите range="month". Для макроэкономических событий (CPI, FOMC, заседания Банка Японии и т.д.) используйте другой инструмент `get_economic_events_today`.

地政学カレンダー（確定済み公式スケジュール: 首脳会談・サミット・選挙・公式リスク日程）

**Инструмент для работы ТОЛЬКО с утверждённым официальным расписанием.** Возвращает 4 подкатегории: встречи на высшем уровне и визиты высокопоставленных лиц (bilateral), международные саммиты G7/G20/IMF/APEC/BRICS/NATO (summit), национальные выборы в крупных странах (election), официальные даты геополитических рисков (введение санкций, сроки действия договоров и т.п., risk). К каждому событию прилагаются: влияние на рынок (market implications — валюты, акции, облигации, сырьё), участники, ссылка на первоисточник. Данные вручную отбираются оператором lit-forge из первоисточников (официальные сайты правительства Японии, международных организаций, частные сводки). **Статические данные, обновляемые PR раз в полгода** — содержат только подтверждённые официальные даты (события, требующие субъективной оценки, не регистрируются). **Важно**: этот инструмент — «календарь», **он не учитывает текущие геополитические риски (обострения конфликтов, внезапные переговоры, неожиданные санкции, сценарии блокады и т.п.)**. Если нужно узнать геополитическую обстановку прямо сейчас, используйте другой инструмент `get_geopolitical_pulse`. **Примечание по использованию**: по умолчанию range=week. Чтобы заглянуть дальше, укажите range="month". Для макроэкономических событий (CPI, FOMC, заседания Банка Японии и т.д.) используйте другой инструмент `get_economic_events_today`.

Параметры

rangeenum
期間: today=本日のみ / week=今日含む 7 日間 / month=今日含む 30 日間。既定 week（地政学は中期視点が要るため）。
todayweekmonth
subcategorystring[]
サブカテゴリ絞り込み: summit=国際サミット・国際会議 / bilateral=首脳会談・要人訪問 / election=主要国選挙 / risk=確定済み地政学リスク（制裁・条約期限等）。未指定で全件
countrystring[]
国コード絞り込み: JP/US/CN/EU/GB/OTHER。複数指定可。未指定で全件
minImportanceenum
最低重要度フィルタ: 1=★以上 / 2=★★以上 / 3=★★★のみ。既定 1
123

get_geopolitical_pulse

Инструмент, возвращающий **геополитическую обстановку прямо сейчас**. Параллельно получает RSS BBC World, Al Jazeera, Google News (поиск по темам), убирает дубликаты и отдаёт метаданные статей, отсортированные по дате/времени публикации по убыванию. Назначение: отслеживать текущие геополитические риски (внезапные саммиты, эскалация конфликтов, введение санкций, сценарии блокады и т.д.). Если в сводке рынка спрашивают про «геополитические события», используйте этот инструмент вместе с `get_geopolitical_calendar` (подтверждённые официальные даты). 【Важное замечание по устройству инструмента】Каждая статья содержит только объективные метаданные (заголовок, источник, дата/время публикации, URL, краткое описание от источника). **Субъективные интерпретации** вроде влияния на рынок (market implications) инструмент не добавляет. Оценка и интерпретация влияния на рынок — задача LLM, которая вызвала инструмент. Основание объективности: в основе лежат метаданные статей, прошедших редакционный отбор в крупных информагентствах, что исключает субъективную предвзятость сборщика данных. 【Примечания по использованию】RSS информагентств обычно отражает свежие новости в течение 5–30 минут. Если какой-то фид не сработал, это отмечается как ошибка в массиве sources, а результаты с остальных фидов всё равно возвращаются (частичный успех). Источники в основном англоязычные. Информация, специфичная для Японии, может отсутствовать (планируется добавить японские фиды, начиная с v0.10).

地政学リアルタイム速報（主要通信社 RSS 集約）

Инструмент, возвращающий **геополитическую обстановку прямо сейчас**. Параллельно получает RSS BBC World, Al Jazeera, Google News (поиск по темам), убирает дубликаты и отдаёт метаданные статей, отсортированные по дате/времени публикации по убыванию. Назначение: отслеживать текущие геополитические риски (внезапные саммиты, эскалация конфликтов, введение санкций, сценарии блокады и т.д.). Если в сводке рынка спрашивают про «геополитические события», используйте этот инструмент вместе с `get_geopolitical_calendar` (подтверждённые официальные даты). 【Важное замечание по устройству инструмента】Каждая статья содержит только объективные метаданные (заголовок, источник, дата/время публикации, URL, краткое описание от источника). **Субъективные интерпретации** вроде влияния на рынок (market implications) инструмент не добавляет. Оценка и интерпретация влияния на рынок — задача LLM, которая вызвала инструмент. Основание объективности: в основе лежат метаданные статей, прошедших редакционный отбор в крупных информагентствах, что исключает субъективную предвзятость сборщика данных. 【Примечания по использованию】RSS информагентств обычно отражает свежие новости в течение 5–30 минут. Если какой-то фид не сработал, это отмечается как ошибка в массиве sources, а результаты с остальных фидов всё равно возвращаются (частичный успех). Источники в основном англоязычные. Информация, специфичная для Японии, может отсутствовать (планируется добавить японские фиды, начиная с v0.10).

Параметры

topicenum
トピック: us-china=米中（首脳会談・貿易・関税・台湾） / middle-east=中東（イラン・ホルムズ・イスラエル・ガザ） / ukraine=ウクライナ・ロシア（和平・侵攻・支援・制裁） / japan=日本外交 / global=地政学全般。既定 global
us-chinamiddle-eastukrainejapanglobal
maxItemsinteger
返す最大記事数。5-30、既定 15
hoursBackinteger
これより古い記事は除外する時間ウィンドウ（時間）。6-48、既定 24

get_market_sessions

返回东京（9:00-15:30 JST）/ 上海（10:30-16:00 JST）/ 伦敦（17:00-25:30 JST）/ 纽约（22:30-29:00 JST）当前的交易时间状态（open / pre-open / closed / holiday）。周末全部为 closed，节假日为 holiday（附带 holidayName）。各市场的节假日日历为手动整理（美英节假日、日本国民节日 + TSE 规定、中国春节等长期休市）。夏令时变更或临时休市未做处理，为近似值。

主要市場の取引時間ステータス

返回东京（9:00-15:30 JST）/ 上海（10:30-16:00 JST）/ 伦敦（17:00-25:30 JST）/ 纽约（22:30-29:00 JST）当前的交易时间状态（open / pre-open / closed / holiday）。周末全部为 closed，节假日为 holiday（附带 holidayName）。各市场的节假日日历为手动整理（美英节假日、日本国民节日 + TSE 规定、中国春节等长期休市）。夏令时变更或临时休市未做处理，为近似值。

Параметры

Без параметров.

get_market_snapshot

USD/JPY, EUR/JPY, GBP/JPY, AUD/JPY, EUR/USD, CHF/JPY, Dollar Index, Nikkei 225, TOPIX, Dow Jones, S&P 500, NASDAQ, VIX, NYSE FANG+, SOX, DAX, FTSE, Shanghai Composite, Hang Seng, KOSPI, SENSEX, US 10-year/5-year bond yields, Gold, Crude Oil, Copper, Bitcoin, Ethereum: текущие значения и изменения за день для этих 28 основных индексов получаются из Yahoo Finance. Это справочные значения с задержкой около 1 часа и не являются инвестиционным советом.

主要マクロ指標スナップショット

USD/JPY, EUR/JPY, GBP/JPY, AUD/JPY, EUR/USD, CHF/JPY, Dollar Index, Nikkei 225, TOPIX, Dow Jones, S&P 500, NASDAQ, VIX, NYSE FANG+, SOX, DAX, FTSE, Shanghai Composite, Hang Seng, KOSPI, SENSEX, US 10-year/5-year bond yields, Gold, Crude Oil, Copper, Bitcoin, Ethereum: текущие значения и изменения за день для этих 28 основных индексов получаются из Yahoo Finance. Это справочные значения с задержкой около 1 часа и не являются инвестиционным советом.

Параметры

Без параметров.

get_market_thermometer

Возвращает композитный риск-он/риск-офф индекс шкалы 0-100, собранный из VIX, изменения S&P 500 за день, изменения доходности 10-летних казначейских облигаций США и изменения индекса доллара. 50 — нейтрально, 70 и выше — риск-он доминирует, 30 и ниже — риск-офф доминирует. Включает баллы каждого компонента и динамику за последние 30 торговых дней. Не инвестиционная рекомендация, а индикатор для общего обзора.

マーケット温度計（リスクオン/オフ合成スコア）

Возвращает композитный риск-он/риск-офф индекс шкалы 0-100, собранный из VIX, изменения S&P 500 за день, изменения доходности 10-летних казначейских облигаций США и изменения индекса доллара. 50 — нейтрально, 70 и выше — риск-он доминирует, 30 и ниже — риск-офф доминирует. Включает баллы каждого компонента и динамику за последние 30 торговых дней. Не инвестиционная рекомендация, а индикатор для общего обзора.

Параметры

Без параметров.

get_performance_ranking

Сортирует 28 инструментов (валюты, акции, процентные ставки, сырьевые товары, криптовалюты) по убыванию доходности за указанный период и возвращает верхние N и нижние N. Для периодов 1 неделя / 1 месяц поддерживаются только 7 основных инструментов: USD/JPY, S&P 500, NASDAQ, NY Dow, US 10Y, VIX, DXY. Это не инвестиционная рекомендация, а только числовая сортировка.

28 銘柄のパフォーマンスランキング

Сортирует 28 инструментов (валюты, акции, процентные ставки, сырьевые товары, криптовалюты) по убыванию доходности за указанный период и возвращает верхние N и нижние N. Для периодов 1 неделя / 1 месяц поддерживаются только 7 основных инструментов: USD/JPY, S&P 500, NASDAQ, NY Dow, US 10Y, VIX, DXY. Это не инвестиционная рекомендация, а только числовая сортировка.

Параметры

periodenum
ソート期間。1d=当日前日比、1w=直近5営業日、1m=直近21営業日
1d1w1m
topNinteger
上位/下位 N 件を返す（デフォルト 5）

get_quote

Получает текущую цену, изменение к предыдущему дню и спарклайн для произвольного тикера Yahoo Finance (акции, валюты, индексы, товары, криптоактивы). Используйте, если нужно проверить показатели, не входящие в 28 метрик из get_market_snapshot. При includeFundamentals=true также получает PER, PBR, дивидендную доходность и бету (для отдельных акций). Не является инвестиционной рекомендацией.

任意ティッカーの現在値取得

Получает текущую цену, изменение к предыдущему дню и спарклайн для произвольного тикера Yahoo Finance (акции, валюты, индексы, товары, криптоактивы). Используйте, если нужно проверить показатели, не входящие в 28 метрик из get_market_snapshot. При includeFundamentals=true также получает PER, PBR, дивидендную доходность и бету (для отдельных акций). Не является инвестиционной рекомендацией.

Параметры

symbolstringобязательный
Yahoo Finance ティッカー。例: AAPL（アップル株）/ ^DJI（NY ダウ）/ BTC-USD（ビットコイン）/ GBPJPY=X（ポンド円）
includeFundamentalsboolean
true で PER / PBR / 配当利回り / ベータ / 時価総額 / 配当性向などのファンダメンタル指標も取得（個別株向け、指数や暗号資産では大半が空）。既定 false

get_sector_heatmap

Секторные ETF американского рынка акций (Technology XLK / Financials XLF / Healthcare XLV / Consumer Discretionary XLY / Consumer Staples XLP / Energy XLE / Industrials XLI / Utilities XLU / Materials XLB / Real Estate XLRE / Communication Services XLC) — получить текущую цену и изменение за день одним запросом. Источник информации для отслеживания секторной ротации на рынке США.

米株セクター ETF 前日比ヒートマップ（SPDR、11 セクター）

Секторные ETF американского рынка акций (Technology XLK / Financials XLF / Healthcare XLV / Consumer Discretionary XLY / Consumer Staples XLP / Energy XLE / Industrials XLI / Utilities XLU / Materials XLB / Real Estate XLRE / Communication Services XLC) — получить текущую цену и изменение за день одним запросом. Источник информации для отслеживания секторной ротации на рынке США.

Параметры

Без параметров.

get_us_macro_latest

Инструмент возвращает последние опубликованные значения трёх основных макроэкономических показателей США (отчёт по занятости, CPI, PPI) + базовые индексы + уровень безработицы + среднюю почасовую оплату, а также изменения к предыдущему месяцу и к тому же месяцу прошлого года. Делает один запрос к Public Data API v2 BLS (Бюро статистики труда США) и возвращает агрегированные данные по 7 сериям. Не требует API-ключа, работает без аутентификации (использует публичное API BLS с лимитом 25 запросов в день для незарегистрированных пользователей, с кэшированием на 6 часов). [Получаемые серии (в v0.14.0 расширено с 4 до 7 серий)] Отчёт по занятости = численность занятых в несельскохозяйственном секторе (CES0000000001, тыс. чел.) / Уровень безработицы (LNS14000000, %) / CPI для всех городских потребителей (CUUR0000SA0, индекс 1982-84=100) / **core CPI** (без учёта продуктов питания и энергии, CUUR0000SA0L1E, индекс) / PPI конечного спроса (WPSFD4, индекс 2009=100) / **core PPI** (без учёта продуктов питания и энергии, WPSFD49104, индекс) / **Средняя почасовая оплата** (частный сектор с сезонной корректировкой, CES0500000003, долл./час). [Возвращаемые данные] По каждому показателю возвращается значение за последний месяц, разница с предыдущим месяцем, процентное изменение к предыдущему месяцу, разница с тем же месяцем прошлого года и процентное изменение к тому же месяцу прошлого года. Для предварительных данных (preliminary) устанавливается preliminary=true, впоследствии они обновляются до окончательных. В месяцах с отсутствием данных (например, когда BLS не смог опубликовать значения из-за остановки правительства) value=null. [Связанные инструменты] Даты предстоящих публикаций смотрите в отдельных инструментах: `get_economic_release_pulse` (календарь официального органа) / `get_economic_events_today` (ручная курация). Этот инструмент отвечает на вопрос «какие сейчас значения показателей», а те — «когда выйдет следующее». [Примечание по использованию] BLS запрещает бот-доступ к HTML-календарю и RSS; с помощью этого инструмента можно автоматически получать только «последние значения». Это агрегация информации, а не инвестиционная рекомендация.

米マクロ最新値（雇用統計・失業率・CPI・PPI）

Инструмент возвращает последние опубликованные значения трёх основных макроэкономических показателей США (отчёт по занятости, CPI, PPI) + базовые индексы + уровень безработицы + среднюю почасовую оплату, а также изменения к предыдущему месяцу и к тому же месяцу прошлого года. Делает один запрос к Public Data API v2 BLS (Бюро статистики труда США) и возвращает агрегированные данные по 7 сериям. Не требует API-ключа, работает без аутентификации (использует публичное API BLS с лимитом 25 запросов в день для незарегистрированных пользователей, с кэшированием на 6 часов). [Получаемые серии (в v0.14.0 расширено с 4 до 7 серий)] Отчёт по занятости = численность занятых в несельскохозяйственном секторе (CES0000000001, тыс. чел.) / Уровень безработицы (LNS14000000, %) / CPI для всех городских потребителей (CUUR0000SA0, индекс 1982-84=100) / **core CPI** (без учёта продуктов питания и энергии, CUUR0000SA0L1E, индекс) / PPI конечного спроса (WPSFD4, индекс 2009=100) / **core PPI** (без учёта продуктов питания и энергии, WPSFD49104, индекс) / **Средняя почасовая оплата** (частный сектор с сезонной корректировкой, CES0500000003, долл./час). [Возвращаемые данные] По каждому показателю возвращается значение за последний месяц, разница с предыдущим месяцем, процентное изменение к предыдущему месяцу, разница с тем же месяцем прошлого года и процентное изменение к тому же месяцу прошлого года. Для предварительных данных (preliminary) устанавливается preliminary=true, впоследствии они обновляются до окончательных. В месяцах с отсутствием данных (например, когда BLS не смог опубликовать значения из-за остановки правительства) value=null. [Связанные инструменты] Даты предстоящих публикаций смотрите в отдельных инструментах: `get_economic_release_pulse` (календарь официального органа) / `get_economic_events_today` (ручная курация). Этот инструмент отвечает на вопрос «какие сейчас значения показателей», а те — «когда выйдет следующее». [Примечание по использованию] BLS запрещает бот-доступ к HTML-календарю и RSS; с помощью этого инструмента можно автоматически получать только «последние значения». Это агрегация информации, а не инвестиционная рекомендация.

Параметры

Без параметров.

get_yield_spread

Возвращает разницу (спред доходности) между доходностью 10-летних казначейских облигаций США (^TNX) и 5-летних казначейских облигаций США (^FVX). Положительное значение — нормальная кривая доходности, отрицательное — инвертированная. Также включает изменение по сравнению с предыдущим днём в базисных пунктах (bp). Справочная информация для инвестиционных решений.

米イールドスプレッド（10y-5y）

Возвращает разницу (спред доходности) между доходностью 10-летних казначейских облигаций США (^TNX) и 5-летних казначейских облигаций США (^FVX). Положительное значение — нормальная кривая доходности, отрицательное — инвертированная. Также включает изменение по сравнению с предыдущим днём в базисных пунктах (bp). Справочная информация для инвестиционных решений.

Параметры

Без параметров.

plan_retirement

По возрасту, текущим сбережениям, ежемесячной сумме накоплений, планируемому возрасту выхода на пенсию, желаемым расходам на жизнь после выхода на пенсию, степени толерантности к риску и получаемой пенсии рассчитывает достаточность будущих активов и пенсионных средств по трём сценариям: оптимистичный, реалистичный, пессимистичный. В случае нехватки автоматически обратным расчётом определяет необходимую ежемесячную сумму, которая позволит достичь цели по реалистичному сценарию.

個人資産形成プランナー（NISA / iDeCo）

По возрасту, текущим сбережениям, ежемесячной сумме накоплений, планируемому возрасту выхода на пенсию, желаемым расходам на жизнь после выхода на пенсию, степени толерантности к риску и получаемой пенсии рассчитывает достаточность будущих активов и пенсионных средств по трём сценариям: оптимистичный, реалистичный, пессимистичный. В случае нехватки автоматически обратным расчётом определяет необходимую ежемесячную сумму, которая позволит достичь цели по реалистичному сценарию.

Параметры

ageintegerобязательный
現在の年齢
currentSavingsnumber
現在の投資資産（円。預金 + 投資商品の合計）
monthlyContributionnumberобязательный
毎月の積立額（円）
retirementAgeintegerобязательный
退職（積立終了）予定年齢
monthlyRetirementSpendnumberобязательный
退職後の月間希望生活費（円）
riskToleranceenum
リスク許容度。conservative=1-5%, balanced=2-6%, aggressive=3-8% の年利想定
conservativebalancedaggressive
pensionMonthlynumber
受給予定の公的年金月額（円）。デフォルト 145,000 は厚生年金の標準値
lifeExpectancyinteger
想定寿命（年）。日本人平均は 84 前後

simulate_nisa

Рассчитывает будущую стоимость, доход от инвестиций и годовую динамику на основе ежемесячной суммы взносов, предполагаемой годовой процентной ставки и срока — с ежемесячной капитализацией процентов. Для простого моделирования NISA / iDeCo.

つみたて NISA シミュレーション

Рассчитывает будущую стоимость, доход от инвестиций и годовую динамику на основе ежемесячной суммы взносов, предполагаемой годовой процентной ставки и срока — с ежемесячной капитализацией процентов. Для простого моделирования NISA / iDeCo.