Trade Agent
官方透過 Trade Agent 執行股票與加密貨幣交易
你可以用 Trade Agent MCP 做什麼?
- 查詢股票或加密貨幣價格 — 使用
search_assets查詢如 TSLA 或 Bitcoin 等代號的當前價格與元數據。 - 查看已連結的經紀帳戶 — 透過
get_accounts列出所有已連接帳戶及其餘額與可用現金。 - 建立股票或加密貨幣訂單草稿 — 使用
create_trade下達包含代號、數量以及可選限價或停損參數的買/賣草稿。 - 建立選擇權訂單草稿 — 使用
create_options_trade建立單腿或多腿選擇權草稿(價差、跨式)。 - 執行已審查的草稿交易 — 使用
execute_trade將已確認的草稿提交給經紀商以進行下單。
文件
Trade It MCP 伺服器
👉 完整文件在此 👈
現已可透過 官方 MCP 註冊表 取得
目錄
概覽
Trade It MCP 伺服器為代理程式帶來股票、加密貨幣和選擇權交易支援。它能讓您以自然語言與股票和加密貨幣券商互動——透過 MCP 協定傳送簡單的英文請求,即可執行交易、查詢投資組合績效,並獲取市場洞察。
端點:
- 可串流的 HTTP:
https://mcp.tradeit.app/mcp - SSE:
https://mcp.tradeit.app/sse
券商支援:
加密貨幣交易所支援:
更多即將推出!
此伺服器為遠端伺服器,因此您無需在本機執行任何程式即可連線。只需將您的 MCP 相容代理平台指向上述網址即可。
入門指南
- 首先,在 https://tradeit.app. 建立帳戶
- 註冊 Pro 方案的免費試用。
- 連結您選擇的券商。
連線
- 將您的 MCP 用戶端連線至
https://mcp.tradeit.app/mcp或https://mcp.tradeit.app/sse。 - 透過瀏覽器型 OAuth 流程進行驗證。
- 您現在已準備好開始交易!
工具
MCP 工具將您的代理程式連結至已連結的券商:搜尋代號、列出帳戶、建立草稿訂單,然後僅在確認後執行。
| MCP 工具 | 功能說明 |
|---|---|
search_assets | 透過股票代號或名稱查詢股票或加密貨幣;回傳價格和中繼資料。 |
get_accounts | 列出已連結的帳戶和餘額;連結新券商時也會使用。 |
create_trade | 建立草稿股票/加密貨幣買入或賣出以供審查。 |
create_options_trade | 建立草稿單邊或多邊選擇權訂單以供審查。 |
execute_trade | 在使用者明確確認後,將先前建立的草稿提交給券商。 |
安全模型(先建立草稿)
交易以 draft 訂單開始,不會在使用者明確確認前傳送至券商。
預期流程:
- 呼叫
create_trade或create_options_trade→ 您會得到一個帶有trade_id的草稿。 - 向使用者顯示完整的訂單詳細資料以及如何繼續。
- 僅在使用者明確要求執行、確認或下單時,才呼叫
execute_trade。 - 不要在建立草稿後自動或立即呼叫
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 | 數字 | 若為限價 / 停損限價 | 適用的每股最高或最低價格。 |
stop_price | 數字 | 若為停損 / 停損限價 | 停損觸發價格。 |
time_in_force | "day"、"gtc"、"ioc"、"fok" | 否 | 省略則使用券商預設值。 |
account_id | 數字 | 否 | 省略則使用預設帳戶。 |
訂單類型:
| 類型 | 使用時機 | 價格欄位 |
|---|---|---|
market | 以目前市價成交 | 無 |
limit | 僅在 limit_price 或更佳價格時 | limit_price |
stop | 市價訂單在 stop_price 觸發 | stop_price |
stop_limit | 限價訂單在 stop_price 觸發 | stop_price 和 limit_price |
JSON 範例:
以市價買入價值 $500 的 Apple:
{ "symbol": "AAPL", "amount": 500, "unit": "dollars", "buy_or_sell": "buy" }
僅在 NVDA 跌至 $800 或以下時買入 10 股:
{ "symbol": "NVDA", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "limit", "limit_price": 800 }
若 Meta 價格跌至 $450(停損)時賣出 5 股:
{ "symbol": "META", "amount": 5, "unit": "shares", "buy_or_sell": "sell", "order_type": "stop", "stop_price": 450 }
若 AAPL 突破 $200 時買入 10 股,每股最多支付 $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" }
自然語言範例: 「買入價值 $1000 的 Tesla」 · 「僅在 Tesla 價格跌至 $150 或更低時買入價值 $1000」 · 「若 Apple 價格跌至 $140 時賣出 10 股」 · 「若 Apple 達到 $200 時買入一股」 · 「若 Apple 漲至 $140 時買入 10 股,但不要支付超過 $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 |
|---|---|
| 2025 年 6 月 20 日 $250 買權 | 250620C00250000 |
| 2025 年 6 月 20 日 $260 買權 | 250620C00260000 |
| 2025 年 3 月 21 日 $500 賣權 | 250321P00500000 |
| 2025 年 12 月 19 日 $1,500 買權 | 251219C01500000 |
| 2026 年 1 月 16 日 $50 賣權 | 260116P00050000 |
履約價編碼:將美元乘以 1,000 並填充至 8 位數(例如 $250 → 00250000;$50.50 → 00050500)。
選擇權 JSON 範例
單一買權 — 買入 1 張 SPY $520 買權,到期日 2025 年 6 月 20 日:
{
"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 買權,到期日 2025 年 3 月 21 日:
{
"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,下週」 · 「SPY 本週五的價平跨式」 · 「2 張 AMZN 賣權,限價 $3.50」 · 「賣出 AMZN260130P00200000」
execute_trade
在使用者審查後,將草稿傳送至券商。
- 參數:
trade_id(數字)— 來自create_trade或create_options_trade的草稿id。 - 回傳: 更新後的交易;狀態為
"placed"或"failed"(附帶錯誤詳細資料)。
僅在使用者明確確認時呼叫(例如執行、確認、下單、開始)。確認與他們剛審查的內容相符的交易。
不要在建立草稿後自動呼叫、未顯示訂單詳細資料時呼叫,或狀態不是 "draft" 時呼叫。
交易狀態參考
| 狀態 | 意義 |
|---|---|
draft | 已建立;尚未傳送至券商 |
pending | 已提交;等待券商確認 |
placed | 已接受;等待成交 |
partially_filled | 部分成交 |
complete | 完全成交 |
canceled | 已取消 |
failed | 已拒絕 — 檢查錯誤 |
disconnected | 券商連線問題 |
券商 ID(API 輔助工具)
| 券商 | ID | 選擇權 |
|---|---|---|
| Robinhood | 1 | 是 |
| E*TRADE | 2 | 是 |
| Coinbase | 3 | 僅加密貨幣 |
| Kraken | 5 | 僅加密貨幣 |
| Charles Schwab | 7 | 是 |
| Webull | 8 | 是 |
| Public | 11 | 是 |
| Tastytrade | 12 | 是 |
釐清: 當訂單類型不明確(例如「以 $200 買入 TSLA」— 限價 vs 停損)、選擇權缺少到期日/履約價、有多個帳戶適用且未選擇任何一個,或一個代號可能代表多種資產時,請一次性詢問所有需要的資訊。當預設值明確時(預設金額、市價訂單、主要帳戶),請跳過多餘的問題。
免責聲明
- 投資涉及風險,包括可能損失本金。
- Trade It 不是財務顧問,不提供投資建議。
- 選擇權涉及重大風險,不適合所有投資者。
- Trade It 無法提取資金、轉移資產或託管資產 — 它只能透過您已連結的券商下單。