Trade Agent

официальный

Выполняйте сделки с акциями и криптовалютами через Trade Agent

Что можно делать с Trade Agent MCP?

  • Поиск цен на акции или криптовалюты — запросите текущую цену и метаданные для тикера, например TSLA или Bitcoin, с помощью search_assets.
  • Просмотр связанных брокерских счетов — выведите список всех подключенных счетов с балансами и доступными денежными средствами через get_accounts.
  • Создание черновиков ордеров на акции или криптовалюты — разместите черновик покупки/продажи с символом, количеством и необязательными параметрами лимита или стопа с помощью create_trade.
  • Создание черновиков опционных ордеров — создайте черновики опционов с одной или несколькими ногами (спреды, стрэддлы) с помощью create_options_trade.
  • Исполнение проверенного черновика сделки — отправьте подтвержденный черновик в брокерскую компанию для размещения с помощью execute_trade.

Документация

Trade It MCP Server

👉 Полная документация здесь 👈

Теперь доступен в Официальном реестре MCP

Содержание

Обзор

Trade It MCP Server добавляет поддержку торговли акциями, криптовалютами и опционами для агентов. Он позволяет взаимодействовать с биржевыми и криптоброкерами на естественном языке — совершать сделки, запрашивать состояние портфеля и получать рыночную информацию, отправляя запросы на простом английском через протокол MCP.

Конечные точки:

  • Потоковый HTTP: https://mcp.tradeit.app/mcp
  • SSE: https://mcp.tradeit.app/sse

Поддержка брокеров:

Поддержка криптобирж:

Скоро будут добавлены новые!

Этот сервер удаленный, поэтому вам не нужно ничего запускать локально для подключения. Просто укажите вашей MCP-совместимой агентской платформе URL-адрес выше.


Начало работы

  1. Сначала создайте учетную запись на https://tradeit.app.
  2. Подпишитесь на бесплатную пробную версию плана Pro.
  3. Подключите выбранного брокера.

Подключение

  1. Подключите ваш MCP-клиент к https://mcp.tradeit.app/mcp или https://mcp.tradeit.app/sse.
  2. Пройдите аутентификацию через браузерный поток OAuth.
  3. Теперь вы готовы начать торговлю!

Инструменты

Инструменты MCP связывают вашего агента с подключенными брокерами: поиск символов, список счетов, создание черновых ордеров, которые исполняются только после подтверждения.

Инструмент MCPЧто он делает
search_assetsПоиск акции или криптовалюты по тикеру или названию; возвращает цену и метаданные.
get_accountsСписок подключенных счетов и балансов; также используется при подключении нового брокера.
create_tradeСоздание чернового ордера на покупку/продажу акций или криптовалюты для проверки.
create_options_tradeСоздание чернового одно- или многоногого опционного ордера для проверки.
execute_tradeОтправка ранее созданного черновика брокеру после явного подтверждения пользователем.

Модель безопасности (сначала черновик)

Сделки начинаются как draft ордера и не отправляются брокеру, пока пользователь явно не подтвердит.

Предполагаемый поток:

  1. Вызовите create_trade или create_options_trade → вы получите черновик с trade_id.
  2. Покажите пользователю полные детали ордера и как действовать дальше.
  3. Вызовите execute_trade только когда пользователь явно попросит исполнить, подтвердить или разместить сделку.
  4. Не вызывайте execute_trade автоматически или сразу после создания черновика.

После создания черновика убедитесь, что пользователь знает, что он может разместить ордер, когда будет готов (например, через элемент управления «Исполнить» в вашем клиенте, если он доступен).

Необязательные шаги перед созданием черновика:

  • search_assets — подтвердить тикер и контекст.
  • get_accounts — выбрать правильный account_id, если пользователю важно, какой счет использовать.

Поток исполнения:

User requests trade
       ↓
[Optional] search_assets — confirm ticker, get current price
       ↓
[Optional] get_accounts — identify correct account_id
       ↓
create_trade / create_options_trade → draft with trade_id, status: "draft"
       ↓
Show draft details; user confirms
       ↓
execute_trade(trade_id)
       ↓
Status: "placed" or "failed" (with details)

Настройки счета/ордера по умолчанию: Если пользователь не указывает сумму, счет или тип ордера, Trade It применяет их сумму по умолчанию, счет по умолчанию и рыночные ордера, где это применимо. Если в настройках Trade It включено автоисполнение, в некоторых конфигурациях шаг ручного исполнения может быть пропущен; в случае сомнений все равно рассматривайте исполнение как подтвержденное пользователем.


search_assets

Поиск акции или криптовалюты по тикеру или названию.

  • Параметр: query (строка) — например, "TSLA", "Tesla", "bitcoin".
  • Возвращает: Цену, тикер, биржу, тип актива и связанные метаданные.

Пример:

{ "query": "TSLA" }

Примеры на естественном языке: «Как дела у Apple?» · «Какая цена TSLA?»


get_accounts

Список всех подключенных брокерских счетов (и используйте этот поток, когда пользователь хочет подключить нового брокера).

  • Параметры: отсутствуют.
  • Возвращает: Счета с id, name, brokerage, balance, available_cash. Используйте account.id как account_id в торговых вызовах, когда требуется конкретный счет.

Пример на естественном языке: «Покажи мои счета».


create_trade

Создание чернового ордера на акции или криптовалюту.

Параметры:

ПолеТипОбязательноОписание
symbolстрокаДаТикер, например, "TSLA".
amountчислоДаРазмер сделки.
unit"dollars" или "shares"ДаЕдиница для amount.
buy_or_sell"buy" или "sell"ДаНаправление.
order_type"market", "limit", "stop", "stop_limit"НетПо умолчанию "market".
limit_priceчислоЕсли limit / stop_limitМаксимальная или минимальная цена за акцию, в зависимости от ситуации.
stop_priceчислоЕсли stop / stop_limitТриггерная цена стоп-ордера.
time_in_force"day", "gtc", "ioc", "fok"НетОпустите для значения по умолчанию брокера.
account_idчислоНетОпустите для счета по умолчанию.

Типы ордеров:

ТипИспользуйте, когдаПоля цены
marketИсполнение по текущей рыночной ценеНет
limitТолько по limit_price или лучшеlimit_price
stopРыночный ордер срабатывает при stop_pricestop_price
stop_limitЛимитный ордер срабатывает при stop_pricestop_price и limit_price

Примеры JSON:

Купить Apple на $500 по рынку:

{ "symbol": "AAPL", "amount": 500, "unit": "dollars", "buy_or_sell": "buy" }

Купить 10 акций NVDA, только если цена упадет до $800 или ниже:

{ "symbol": "NVDA", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "limit", "limit_price": 800 }

Продать 5 акций Meta, если цена упадет до $450 (стоп):

{ "symbol": "META", "amount": 5, "unit": "shares", "buy_or_sell": "sell", "order_type": "stop", "stop_price": 450 }

Купить 10 AAPL, если цена пробьет $200 вверх, заплатив не более $202 за акцию:

{ "symbol": "AAPL", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "stop_limit", "stop_price": 200, "limit_price": 202 }

Купить биткоин на $1,000:

{ "symbol": "BTC", "amount": 1000, "unit": "dollars", "buy_or_sell": "buy" }

Продать 100 акций Tesla, действительно до отмены:

{ "symbol": "TSLA", "amount": 100, "unit": "shares", "buy_or_sell": "sell", "time_in_force": "gtc" }

Примеры на естественном языке: «Купи Tesla на $1000» · «Купи Tesla на $1000, только если цена упадет до $150 или ниже» · «Продай 10 акций Apple, если цена упадет до $140» · «Купи акцию Apple, если она достигнет $200» · «Купи 10 акций Apple, если она вырастет до $140, но не плати больше $142»


create_options_trade

Создание чернового одноногого или многоногого опционного ордера (спреды, стреддлы и т.д.).

Параметры:

ПолеТипОбязательноОписание
symbolстрокаДаБазовый тикер, например, "SPY".
legsмассивДаОдна или несколько ног (см. ниже).
direction"debit" или "credit"Для многих ног"debit" = вы платите; "credit" = вы получаете.
order_type"market", "limit" и т.д.НетПо умолчанию "market".
limit_priceчислоДля лимитныхЛимит чистого дебета/кредита для пакета.
time_in_force"day" или "gtc"НетОпустите для значения по умолчанию.
account_idчислоНетОпустите для счета по умолчанию.

Каждая нога:

ПолеТипОбязательноОписание
type"option" или "equity"ДаТип ноги.
action"buy" или "sell"ДаСторона ноги.
position_effect"open" или "close"Для опционовОткрыть новую позицию или закрыть существующую.
occстрока или nullДля опционовСтрока OCC (ниже); null для ног с акциями.
quantityчислоДаКонтракты (опционы) или акции (акции).

Формат символа опциона OCC

Строки OCC следуют формату: YYMMDD + C или P + 8-значный страйк (страйк × 1000, с дополнением нулями).

ОписаниеOCC
20 июня 2025, колл $250250620C00250000
20 июня 2025, колл $260250620C00260000
21 марта 2025, пут $500250321P00500000
19 декабря 2025, колл $1,500251219C01500000
16 января 2026, пут $50260116P00050000

Кодирование страйка: умножьте доллары на 1 000 и дополните до 8 цифр (например, $250 → 00250000; $50.50 → 00050500).

Примеры JSON для опционов

Одиночный колл — купить 1 колл SPY $520 с экспирацией 20 июня 2025:

{
  "symbol": "SPY",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00520000", "quantity": 1 }
  ]
}

Бычий колл-спред (дебет) — купить колл $250, продать колл $260, та же экспирация:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Медвежий пут-спред (дебет):

{
  "symbol": "SPY",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00520000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 }
  ]
}

Бычий пут-спред (кредит):

{
  "symbol": "SPY",
  "direction": "credit",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00500000", "quantity": 1 }
  ]
}

Спред с лимитом — чистый дебет $3.50 или лучше:

{
  "symbol": "TSLA",
  "direction": "debit",
  "order_type": "limit",
  "limit_price": 3.50,
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Закрыть длинный колл — продать для закрытия 2 колла AAPL $200 с экспирацией 21 марта 2025:

{
  "symbol": "AAPL",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "close", "occ": "250321C00200000", "quantity": 2 }
  ]
}

Стреддл — длинный колл $250 и пут $250, та же экспирация:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00250000", "quantity": 1 }
  ]
}

Примеры на естественном языке: «Купи 1 колл AAPL $300 с экспирацией в следующем месяце» · «Покрытый колл на MSFT со страйком $500» · «Колл-спред TSLA: купи $475 / продай $485, следующая неделя» · «ATM стреддл на SPY в эту пятницу» · «2 пута AMZN, лимит $3.50» · «Продай AMZN260130P00200000»


execute_trade

Отправка черновика брокеру после того, как пользователь его проверил.

  • Параметр: trade_id (число) — id черновика из create_trade или create_options_trade.
  • Возвращает: Обновленную сделку; статус "placed" или "failed" (с деталями ошибки).

Вызывайте только когда пользователь явно подтверждает (например, исполнить, подтвердить, разместить, давай). Подтвердите сделку, которая соответствует тому, что они только что проверили.

Не вызывайте автоматически сразу после создания черновика, не показывая детали ордера, или когда статус не "draft".


Справочник статусов сделок

СтатусЗначение
draftСоздан; еще не отправлен брокеру
pendingОтправлен; ожидание подтверждения брокера
placedПринят; ожидание исполнения
partially_filledЧастично исполнен
completeПолностью исполнен
canceledОтменен
failedОтклонен — проверьте ошибки
disconnectedПроблема с подключением к брокеру

Идентификаторы брокеров (помощники API)

БрокерIDОпционы
Robinhood1Да
E*TRADE2Да
Coinbase3Только крипто
Kraken5Только крипто
Charles Schwab7Да
Webull8Да
Public11Да
Tastytrade12Да

Уточнение: Спрашивайте один раз, со всем необходимым, когда: тип ордера неоднозначен (например, «купи TSLA по $200» — лимитный или стоп), в опционах отсутствует экспирация/страйк, применимы несколько счетов и ни один не выбран, или символ может означать более одного актива. Пропускайте избыточные вопросы, когда значения по умолчанию ясны (сумма по умолчанию, рыночный ордер, основной счет).

Отказ от ответственности

  • Инвестирование сопряжено с риском, включая возможную потерю основной суммы.
  • Trade It не является финансовым консультантом и не предоставляет инвестиционных советов.
  • Опционы связаны со значительным риском и подходят не всем инвесторам.
  • Trade It не может выводить средства, переводить активы или принимать их на хранение — он может только размещать сделки через ваши подключенные брокерские счета.