KyuRish/trading212-mcp-server

Отменяет ожидающий ордер и удаляет его из книги ордеров. Это действие необратимо — после отмены ордер нельзя восстановить, его нужно размещать заново. Сначала вызовите fetch_all_orders или fetch_order, чтобы убедиться, что ордер ещё активен, прежде чем пытаться его отменить. Args: order_id: Числовой идентификатор ожидающего ордера для отмены (например, 12345678). Получите его из fetch_all_orders или из ответа при размещении ордера.

Создаёт новый инвестиционный портфель с указанными инструментами и целевыми весами. Создаётся реальный портфель в вашем аккаунте – инструменты будут куплены, когда вы пополните портфель. Перед созданием используйте search_instrument, чтобы найти корректные тикеры. Веса должны в сумме давать 1.0 (100%). См. также: duplicate_pie для клонирования существующего портфеля. Args: name: Отображаемое имя портфеля (например, 'Tech Growth') instrument_shares: Соответствие тикера и целевого веса, сумма должна быть 1.0. Пример: {'AAPL_US_EQ': 0.5, 'MSFT_US_EQ': 0.3, 'NVDA_US_EQ': 0.2} dividend_cash_action: REINVEST (докупить акции) или TO_ACCOUNT_CASH (вывести в кэш). Если не указано, по умолчанию REINVEST. end_date: Опциональная целевая дата в формате ISO 8601 (например, '2029-12-31T23:59:59Z') goal: Опциональная целевая сумма в валюте аккаунта (например, 20000.0) icon: Опциональный идентификатор иконки портфеля (например, 'Coins', 'Education') Returns: PieDetails: Полные детали только что созданного портфеля

Окончательно удаляет пирог. Это действие необратимо. Инструменты внутри пирога становятся отдельными позициями в вашем портфеле — они не продаются. Перед удалением сначала используйте fetch_a_pie, чтобы просмотреть содержимое пирога. Подумайте, не хотите ли вы продать позиции по отдельности после удаления. Параметры: pie_id: Числовой идентификатор удаляемого пирога (например, 6894572). Возьмите его из fetch_pies.

Клонирует существующий пирог в новый — с теми же распределениями инструментов и настройками. У нового пирога нулевая вложенная стоимость. Используйте это, чтобы создать вариацию существующего пирога, не собирая его с нуля. Также см. `create_pie` — для создания пирога с нуля. Args: pie_id: ID исходного пирога для копирования (например, 6894572). Получить можно из `fetch_pies`. name: Необязательное имя для клона. По умолчанию — исходное имя с суффиксом. icon: Необязательная иконка для клона. Returns: PieDetails: Полные данные нового клонированного пирога

Получите детальную разбивку баланса счета: доступные средства, инвестированный капитал, прибыль/убыток, заблокированные средства и средства в пирогах. Используйте, чтобы проверить доступную покупательную способность перед размещением заказов или чтобы понять общее состояние счета. См. также: fetch_portfolio_summary для более полного обзора, включающего отдельные позиции. Возвращает: Cash со значениями free, invested, total, ppl (прибыль/убыток), result, blocked, pieCash

Получить метаданные аккаунта: валюту и уникальный идентификатор. Используйте этот вызов как отправную точку — он определяет базовую валюту аккаунта, прежде чем вы начнёте интерпретировать денежные суммы из других инструментов. Вызывать можно часто, это безопасно. Возвращает: Account с id (int) и currencyCode (например, 'EUR', 'GBP', 'USD')

Получить все открытые позиции в портфеле с текущими ценами, количеством, себестоимостью и нереализованной прибылью. Используйте это, чтобы получить полную картину текущих активов. Каждая позиция включает тикер, количество, averagePrice, currentPrice и ppl (прибыль/убыток). Позиции, находящиеся внутри pies, имеют ненулевое поле pieQuantity. См. также: search_specific_position_by_ticker для поиска одной позиции, или fetch_portfolio_summary для сводного представления портфеля. Возвращает: список объектов Position, по одному на каждый удерживаемый инструмент

Вывести список всех активных ожидающих ордеров (limit, stop, stop-limit), ожидающих исполнения. Используйте это, чтобы просмотреть открытые ордера перед размещением новых или чтобы проверить, активен ли ранее размещённый ордер. Не включает исполненные или отменённые ордера - для них используйте fetch_historical_order_data. Возвращает: список объектов Order с полями id, ticker, type, status, quantity, limitPrice, stopPrice

Получает полную информацию по одному pie: распределение всех инструментов, текущие и целевые веса, прибыль/убыток по каждому инструменту и настройки pie. Сначала вызовите fetch_pies, чтобы получить список идентификаторов pie, затем используйте этот инструмент для детальной разбивки конкретного pie. Args: pie_id: Числовой идентификатор pie (например, 6894572). Берется из fetch_pies. Returns: PieDetails с настройками (name, goal, endDate, dividendCashAction) и инструментами (ticker, expectedShare, currentShare, ownedQuantity, result)

Анализирует историю дивидендного дохода: собирает до 200 записей о дивидендах и разбивает их по тикерам и календарным месяцам. Используйте это, чтобы определить, какие активы приносят наибольший доход, и выявить ежемесячные тенденции. Для получения сырых записей о дивидендах с пагинацией используйте fetch_paid_out_dividends. Возвращает: dict с полями currency, total_dividends, dividend_count, average_monthly, by_ticker (отсортировано от самых высоких выплат к низким), by_month (в хронологическом порядке)

Выводит все ранее созданные CSV-экспорты аккаунтов с их статусом и ссылками на скачивание. Используйте этот инструмент, чтобы проверить, готов ли экспорт, запрошенный через request_csv_export, к скачиванию. Готовые отчёты содержат поле downloadLink. Возвращает: Список объектов Report с полями reportId, status и downloadLink (когда готов).

Извлекает прошлые заказы (исполненные, отменённые, отклонённые) с деталями исполнения, ценами исполнения и временными метками. Поддерживает пагинацию и фильтрацию по тикеру. Используйте, чтобы просмотреть историю сделок или проанализировать качество прошлых исполнений. Для текущих активных заказов используйте fetch_all_orders. Аргументы: cursor: Курсор пагинации из предыдущего ответа. Пропустите для первой страницы. ticker: Отфильтровать результаты по конкретному инструменту (например, 'AAPL_US_EQ'). Пропустите для всех инструментов. limit: Количество заказов на странице, 1-50. По умолчанию 20. Возвращает: Список HistoricalOrder с тикером, типом, статусом, filledQuantity, fillPrice, dateCreated, dateExecuted и другими полями.

Получает один отложенный ордер по его ID, чтобы проверить его текущий статус, прогресс заполнения и ценовые параметры. Используйте после размещения ордера для отслеживания его статуса, или перед отменой, чтобы убедиться, что ордер всё ещё активен. См. также: fetch_all_orders для вывода всех отложенных ордеров сразу. Аргументы: order_id: Числовой ID ордера, возвращённый при размещении ордера (например, 12345678) Возвращает: Объект Order с полями id, ticker, type, status, quantity, filledQuantity, limitPrice, stopPrice

Получает полученные дивидендные выплаты, включая суммы на акцию, даты выплат и общие суммы. Поддерживает постраничную навигацию и фильтрацию по тикеру. Используйте для отслеживания дохода от дивидендных акций. Для сводного представления, сгруппированного по тикеру и месяцу, используйте fetch_dividend_summary. Аргументы: cursor: Курсор постраничной навигации из предыдущего ответа. Пропустите для первой страницы. ticker: Фильтр по конкретному инструменту (например, 'AAPL_US_EQ'). Пропустите для всех. limit: Количество записей на странице, от 1 до 50. По умолчанию 20. Возвращает: PaginatedDividends с элементами (ticker, amount, paidOn, quantity) и nextPagePath

Вывести список всех инвестиционных портфелей с их остатками денежных средств, деталями по дивидендам, прогрессом по целям и общей доходностью инвестиций. Используйте это, чтобы получить обзор всех портфелей перед тем, как перейти к конкретному с помощью fetch_a_pie. Каждый портфель включает свой числовой ID, необходимый для других операций с портфелями. Возвращает: Список объектов PieSummary с полями id, status, cash, progress, result, dividendDetails

Строит подробный отчёт по эффективности всех позиций, объединяя текущие активы, историю недавних ордеров и выплаты дивидендов. Рассчитывает общую доходность по каждой позиции (прибыль/убыток от цены + дивиденды) и определяет лучшие и худшие результаты. Используйте для более глубокого анализа по сравнению с fetch_portfolio_summary, особенно когда важны дивидендные доходы. Возвращает: dict с полями currency, total_price_ppl, total_dividends, total_return, best_performer, worst_performer, positions (каждая с полями invested, current_value, price_ppl, dividends, total_return, return_pct, held_since), recent_filled_orders

Сформируй полный снимок портфеля за один вызов: объедини информацию об аккаунте, баланс наличных и все открытые позиции в один агрегированный ответ. Это рекомендуемая отправная точка для анализа портфеля. Она считает общую стоимость, процент прибыли/убытка и сортирует активы по текущей стоимости. Чтобы посмотреть эффективность по каждой позиции с учётом дивидендов, используй fetch_portfolio_performance. Возвращает: словарь с полями currency, total_value, cash_available, invested, profit_loss, profit_loss_pct, position_count, positions (отсортированы по стоимости по убыванию) и top_holdings (топ-5)

Получить объединённую временную шкалу недавних сделок и движений по счёту, объединив историю ордеров с депозитами и выводами в единую хронологически отсортированную ленту. Используйте для быстрого обзора «что произошло недавно». Каждая запись помечена как 'order' (сделка) или 'transaction' (движение денег). Для раздельного доступа используйте fetch_historical_order_data или fetch_transaction_list. Args: limit: Сколько элементов брать из каждого источника (ордеров и транзакций отдельно), 1-50. По умолчанию 20. Всего элементов активности может быть до 2x от этого числа. Returns: dict с ключами currency, activity (отсортировано от новых к старым, каждая запись помечена как 'order' или 'transaction'), order_count, transaction_count

Получает движения денежных средств по счёту: депозиты, снятия, комиссии, процентные платежи и внутренние переводы. Поддерживает пагинацию на основе курсора. Используйте эту функцию для аудита денежного потока по счёту или сверки депозитов и снятий. Если нужна сводка по ордерам и транзакциям вместе — используйте fetch_recent_activity. Аргументы: cursor: Курсор пагинации из предыдущего ответа. Не указывайте для первой страницы. time: Фильтровать транзакции от этой метки времени в формате ISO 8601 (например, '2024-06-01T00:00:00Z') и далее. Не указывайте для всех транзакций. limit: Количество записей на странице, от 1 до 50. По умолчанию 20. Возвращает: PaginatedTransactions с элементами (type, dateTime, amount, reference) и nextPagePath

Отправляет лимитный ордер, который исполняется только когда инструмент достигает целевой цены. Ордер остаётся открытым, пока не исполнится, не будет отменён или не истечёт. Используйте этот тип ордера вместо рыночного, когда хотите контролировать цену исполнения. После отправки проверьте fetch_all_orders, чтобы отследить статус исполнения. Аргументы: ticker: Тикер инструмента (например, 'AAPL_US_EQ'). Используйте search_instrument, чтобы найти подходящие тикеры. quantity: Количество акций. Положительное — покупка, отрицательное — продажа. limit_price: Максимальная цена для покупки или минимальная для продажи. Например, 150.00 означает «купить по 150 или ниже». time_validity: Как долго ордер остаётся активным. DAY (истекает в конце торгового дня) или GOOD_TILL_CANCEL (остаётся открытым до исполнения или ручной отмены). По умолчанию DAY. Возвращает: Order: Новый лимитный ордер со статусом ожидания.

Исполняет рыночный ордер по текущей цене. Создаёт реальную сделку, которая мгновенно меняет ваш портфель. Ордер исполняется по лучшей доступной рыночной цене. Сначала используйте search_instrument, чтобы найти правильный тикер. Перед размещением проверьте fetch_account_cash, чтобы убедиться, что хватает средств для покупки. Аргументы: ticker: Тикер инструмента для торговли (например, 'AAPL_US_EQ', 'MSFT_US_EQ'). Используйте search_instrument, чтобы найти корректные тикеры. quantity: Количество акций. Положительное для покупки, отрицательное для продажи. Поддерживаются дробные акции (например, 0.5). Возвращает: Order: Созданный ордер с его начальным статусом.

Размещает комбинированный стоп-лимитный ордер: как только цена достигает стоп-цены, выставляется лимитный ордер по указанной вами лимитной цене, а не исполняется по рыночной. Это даёт больше контроля, чем обычный стоп-ордер, — исполнение не происходит по невыгодной цене при резких движениях рынка, но ордер может не исполниться, если цена пройдёт сквозь лимит. Также смотрите: place_stop_order для более простого стоп-ордера, который гарантирует исполнение. Параметры: - ticker: Тикер инструмента (например, 'AAPL_US_EQ'). Используйте search_instrument для поиска подходящих тикеров. - quantity: Количество акций. Положительное — на покупку, отрицательное — на продажу. - stop_price: Цена срабатывания, активирующая лимитный ордер (например, 140.00). - limit_price: Цена, по которой выставляется результирующий лимитный ордер (например, 139.50). Обычно для продажи устанавливается чуть ниже стоп-цены. - time_validity: DAY или GOOD_TILL_CANCEL. По умолчанию DAY. Возвращает: - Order: Созданный стоп-лимитный ордер.

Размещает стоп-ордер, который выполняет рыночную сделку при достижении инструментом указанной стоп-цены. Обычно используется как стоп-лосс для ограничения риска снижения по существующей позиции. При достижении стоп-цены ордер становится рыночным и исполняется по лучшей доступной цене (которая на быстрых рынках может отличаться от стоп-цены). Для большего контроля над ценой исполнения используйте place_stop_limit_order. Аргументы: ticker: Тикер инструмента (например, 'AAPL_US_EQ'). Используйте search_instrument для поиска валидных тикеров. quantity: Количество акций. Положительное — покупка, отрицательное — продажа. stop_price: Цена срабатывания, активирующая ордер (например, 140.00). time_validity: DAY или GOOD_TILL_CANCEL. По умолчанию DAY. Возвращает: Order: Созданный стоп-ордер

Поставьте в очередь CSV-экспорт истории вашего аккаунта. Экспорт выполняется асинхронно - проверяйте fetch_exports_list, чтобы отслеживать прогресс и получить ссылку для скачивания. Это создаёт задачу экспорта на стороне сервера. Каждый вызов формирует новый отчёт. Используйте параметры временного диапазона, чтобы ограничить экспорт определённым периодом. Args: include_dividends: Включать записи о выплате дивидендов. По умолчанию True. include_interest: Включать записи о выплате процентов. По умолчанию True. include_orders: Включать историю сделок/заявок. По умолчанию True. include_transactions: Включать записи о депозитах/выводах. По умолчанию True. time_from: Начало отчётного окна в формате ISO 8601 (например, '2024-01-01T00:00:00Z'). Опустите для всей истории. time_to: Конец отчётного окна в формате ISO 8601 (например, '2024-12-31T23:59:59Z'). Опустите для данных до текущего момента. Returns: EnqueuedReport с полем reportId для отслеживания через fetch_exports_list

Ищет биржи по названию или числовому идентификатору. Возвращает сведения о бирже, включая торговые часы и рабочие графики. Используйте, чтобы проверить, открыта ли конкретная биржа для торгов, или чтобы найти информацию о бирже по её числовому идентификатору из поля workingScheduleId инструмента. Аргументы: search_term: Текст для сопоставления с названиями бирж без учёта регистра (например, 'NASDAQ', 'London') или точный числовой идентификатор биржи (например, '71'). Если не указан, возвращаются все биржи. Возвращает: Список объектов Exchange с полями id, name и workingSchedules.

Ищет торгуемые инструменты по тикеру или названию компании. Возвращает подходящие инструменты с их тикером, ISIN, валютой и типом. Используйте это перед размещением заказов или созданием пирогов, чтобы найти правильный формат тикера Trading 212 (например, 'AAPL_US_EQ' для Apple). Пропустите поисковый запрос, чтобы получить полный каталог инструментов. Поиск нечувствителен к регистру и находит частичные совпадения как по тикерам, так и по названиям инструментов. Args: search_term: Текст для поиска по тикерам и названиям (например, 'Apple', 'AAPL', 'silver ETC'). Опустите, чтобы получить все доступные инструменты. Returns: Список объектов Instrument с полями ticker, name, type (STOCK/ETF), currencyCode, isin, shortName и maxOpenQuantity

Находит одну открытую позицию по её точному тикеру. Используй, когда нужны детали по одной конкретной позиции, без загрузки всего портфеля. Возвращает те же данные Position, что и fetch_all_open_positions, но для одного инструмента. Аргументы: ticker: Точный тикер Trading 212 (например, 'AAPL_US_EQ', 'IGLDd_EQ'). Если не уверен, воспользуйся search_instrument, чтобы найти правильный тикер. Возвращает: Position с полями ticker, quantity, averagePrice, currentPrice, ppl и другими.

Изменяет настройки существующего портфеля, распределение инструментов или целевые веса. Обновляются только указанные поля — пропущенные остаются без изменений. Сначала используйте fetch_a_pie, чтобы посмотреть текущую конфигурацию перед внесением изменений. API требует указывать название, даже если вы его не меняете. Аргументы: pie_id: Числовой ID портфеля для изменения (например, 6894572). Получите его из fetch_pies. name: Новое название портфеля. API требует его указывать, даже если оно не меняется. instrument_shares: Новое отображение тикеров на веса — сумма должна равняться 1.0. Пример: {'AAPL_US_EQ': 0.5, 'MSFT_US_EQ': 0.5} dividend_cash_action: REINVEST или TO_ACCOUNT_CASH end_date: Новая дата окончания в формате ISO 8601 (например, '2029-12-31T23:59:59Z') goal: Новое целевое значение в валюте счёта (например, 25000.0) icon: Обновлённый идентификатор иконки Возвращает: PieDetails — портфель после применения изменений