Trade Agent MCP Server

chính thức

Thực hiện giao dịch cổ phiếu và tiền điện tử qua Trade Agent

GitHub
54

Tài liệu

Trade It MCP Server

👉 Tài Liệu Đầy Đủ Tại Đây 👈

Hiện có sẵn thông qua Official MCP Registry

Mục lục

Tổng quan

Trade It MCP Server mang đến hỗ trợ giao dịch cổ phiếu, tiền điện tử và quyền chọn cho các tác nhân. Nó cho phép tương tác bằng ngôn ngữ tự nhiên với các sàn môi giới cổ phiếu và tiền điện tử—thực hiện giao dịch, truy vấn hiệu suất danh mục đầu tư và hiển thị thông tin thị trường bằng cách gửi yêu cầu bằng tiếng Anh đơn giản qua giao thức MCP.

Điểm cuối:

  • HTTP có thể truyền trực tuyến: https://mcp.tradeit.app/mcp
  • SSE: https://mcp.tradeit.app/sse

Hỗ trợ môi giới:

Hỗ trợ sàn tiền điện tử:

Sẽ sớm bổ sung thêm!

Máy chủ này là từ xa nên bạn không cần chạy bất cứ thứ gì cục bộ để kết nối. Chỉ cần trỏ nền tảng tác nhân tương thích MCP của bạn đến URL ở trên.

Bắt đầu

  1. Trước tiên, tạo tài khoản tại https://tradeit.app.
  2. Đăng ký dùng thử miễn phí gói Pro.
  3. Kết nối sàn môi giới bạn chọn.

Kết nối

  1. Kết nối máy khách MCP của bạn với https://mcp.tradeit.app/mcp hoặc https://mcp.tradeit.app/sse.
  2. Xác thực qua luồng OAuth dựa trên trình duyệt.
  3. Bạn đã sẵn sàng để bắt đầu giao dịch!

Công cụ

Các công cụ MCP kết nối tác nhân của bạn với các sàn môi giới đã liên kết: tìm kiếm ký hiệu, liệt kê tài khoản, tạo lệnh nháp, sau đó chỉ thực hiện sau khi xác nhận.

Công cụ MCPChức năng
search_assetsTra cứu cổ phiếu hoặc tiền điện tử theo mã hoặc tên; trả về giá và siêu dữ liệu.
get_accountsLiệt kê các tài khoản đã liên kết và số dư; cũng được dùng khi liên kết sàn môi giới mới.
create_tradeTạo lệnh mua hoặc bán cổ phiếu/tiền điện tử nháp để xem xét.
create_options_tradeTạo lệnh quyền chọn một chân hoặc nhiều chân nháp để xem xét.
execute_tradeGửi lệnh nháp đã tạo trước đó đến sàn môi giới sau khi người dùng xác nhận rõ ràng.

Mô hình an toàn (nháp-trước)

Giao dịch bắt đầu dưới dạng lệnh draft và không được gửi đến sàn môi giới cho đến khi người dùng xác nhận rõ ràng.

Luồng dự kiến:

  1. Gọi create_trade hoặc create_options_trade → bạn nhận được bản nháp với trade_id.
  2. Hiển thị cho người dùng chi tiết đầy đủ của lệnh và cách tiến hành.
  3. Gọi execute_trade chỉ khi người dùng yêu cầu rõ ràng để thực hiện, xác nhận hoặc đặt lệnh.
  4. Không gọi execute_trade tự động hoặc ngay sau khi tạo bản nháp.

Sau khi tạo bản nháp, đảm bảo người dùng biết họ có thể đặt lệnh khi sẵn sàng (ví dụ: qua điều khiển Thực hiện của máy khách, nếu có).

Các bước tùy chọn trước khi tạo bản nháp:

  • search_assets — xác nhận mã và ngữ cảnh.
  • get_accounts — chọn đúng account_id khi người dùng quan tâm nên dùng tài khoản nào.

Luồng thực hiện:

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)

Mặc định tài khoản / lệnh: Nếu người dùng bỏ qua số tiền, tài khoản hoặc loại lệnh, Trade It áp dụng số tiền mặc định, tài khoản mặc định và lệnh thị trường khi phù hợp. Nếu tự động thực hiện được bật trong cài đặt Trade It, hành vi có thể bỏ qua bước thực hiện thủ công trong một số thiết lập; khi nghi ngờ, vẫn coi việc thực hiện là do người dùng xác nhận.

search_assets

Tra cứu cổ phiếu hoặc tiền điện tử theo mã hoặc tên.

  • Tham số: query (chuỗi) — ví dụ: "TSLA", "Tesla", "bitcoin".
  • Trả về: Giá, mã, sàn giao dịch, loại tài sản và siêu dữ liệu liên quan.

Ví dụ:

{ "query": "TSLA" }

Ví dụ ngôn ngữ tự nhiên: "Apple đang thế nào?" · "Giá TSLA là bao nhiêu?"

get_accounts

Liệt kê tất cả tài khoản môi giới đã liên kết (và dùng luồng này khi người dùng muốn kết nối sàn môi giới mới).

  • Tham số: không có.
  • Trả về: Tài khoản với id, name, brokerage, balance, available_cash. Dùng account.id làm account_id trong các lệnh gọi giao dịch khi cần tài khoản cụ thể.

Ví dụ ngôn ngữ tự nhiên: "Hiển thị tài khoản của tôi."

create_trade

Tạo lệnh cổ phiếu hoặc tiền điện tử nháp.

Tham số:

TrườngLoạiBắt buộcMô tả
symbolchuỗiCóMã, ví dụ: "TSLA".
amountsốCóKhối lượng giao dịch.
unit"dollars" hoặc "shares"CóĐơn vị cho amount.
buy_or_sell"buy" hoặc "sell"CóHướng.
order_type"market", "limit", "stop", "stop_limit"KhôngMặc định là "market".
limit_pricesốNếu giới hạn / giới hạn dừngGiá tối đa hoặc tối thiểu mỗi cổ phiếu tùy trường hợp.
stop_pricesốNếu dừng / giới hạn dừngGiá kích hoạt dừng.
time_in_force"day", "gtc", "ioc", "fok"KhôngBỏ qua để dùng mặc định của sàn môi giới.
account_idsốKhôngBỏ qua để dùng tài khoản mặc định.

Loại lệnh:

LoạiDùng khiTrường giá
marketKhớp tại giá thị trường hiện tạiKhông có
limitChỉ tại limit_price hoặc tốt hơnlimit_price
stopLệnh thị trường kích hoạt tại stop_pricestop_price
stop_limitLệnh giới hạn kích hoạt tại stop_pricestop_price và limit_price

Ví dụ JSON:

Mua $500 Apple theo giá thị trường:

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

Mua 10 cổ phiếu NVDA chỉ khi giá giảm xuống $800 hoặc thấp hơn:

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

Bán 5 cổ phiếu Meta nếu giá giảm xuống $450 (dừng):

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

Mua 10 AAPL nếu giá vượt qua $200, trả tối đa $202/cổ phiếu:

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

Mua $1,000 Bitcoin:

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

Bán 100 cổ phiếu Tesla, có hiệu lực đến khi hủy:

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

Ví dụ ngôn ngữ tự nhiên: "Mua $1000 Tesla" · "Mua $1000 Tesla chỉ khi giá giảm xuống $150 hoặc thấp hơn" · "Bán 10 cổ phiếu Apple nếu giá giảm xuống $140" · "Mua một cổ phiếu Apple nếu giá chạm $200" · "Mua 10 cổ phiếu Apple nếu giá tăng lên $140, nhưng không trả quá $142"

create_options_trade

Tạo lệnh quyền chọn một chân hoặc nhiều chân nháp (chênh lệch, straddle, v.v.).

Tham số:

TrườngLoạiBắt buộcMô tả
symbolchuỗiCóMã cơ sở, ví dụ: "SPY".
legsmảngCóMột hoặc nhiều chân (xem bên dưới).
direction"debit" hoặc "credit"Nhiều chân"debit" = bạn trả; "credit" = bạn thu.
order_type"market", "limit", v.v.KhôngMặc định là "market".
limit_pricesốCho giới hạnGiới hạn ghi nợ/tín dụng ròng cho gói.
time_in_force"day" hoặc "gtc"KhôngBỏ qua để dùng mặc định.
account_idsốKhôngBỏ qua để dùng tài khoản mặc định.

Mỗi chân:

TrườngLoạiBắt buộcMô tả
type"option" hoặc "equity"CóLoại chân.
action"buy" hoặc "sell"CóPhía của chân.
position_effect"open" hoặc "close"Quyền chọnMở vị thế mới hoặc đóng vị thế hiện có.
occchuỗi hoặc nullQuyền chọnChuỗi OCC (bên dưới); null cho chân cổ phiếu.
quantitysốCóHợp đồng (quyền chọn) hoặc cổ phiếu (cổ phiếu).

Định dạng ký hiệu quyền chọn OCC

Chuỗi OCC tuân theo: YYMMDD + C hoặc P + giá thực hiện 8 chữ số (giá thực hiện × 1000, đệm số không).

Mô tảOCC
20/06/2025 $250 call250620C00250000
20/06/2025 $260 call250620C00260000
21/03/2025 $500 put250321P00500000
19/12/2025 $1,500 call251219C01500000
16/01/2026 $50 put260116P00050000

Mã hóa giá thực hiện: nhân đô la với 1.000 và đệm thành 8 chữ số (ví dụ: $250 → 00250000; $50.50 → 00050500).

Ví dụ JSON quyền chọn

Call đơn — mua 1 SPY $520 call hết hạn 20/06/2025:

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

Bull call spread (ghi nợ) — mua $250 call, bán $260 call, cùng ngày hết hạn:

{
  "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 }
  ]
}

Bear put spread (ghi nợ):

{
  "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 }
  ]
}

Bull put spread (tín dụng):

{
  "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 }
  ]
}

Spread với giới hạn — ghi nợ ròng $3.50 hoặc tốt hơn:

{
  "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 }
  ]
}

Đóng call dài — bán để đóng 2 AAPL $200 call hết hạn 21/03/2025:

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

Straddle — mua $250 call và $250 put, cùng ngày hết hạn:

{
  "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 }
  ]
}

Ví dụ ngôn ngữ tự nhiên: "Mua 1 AAPL $300 call hết hạn tháng sau" · "Covered call trên MSFT tại giá thực hiện $500" · "TSLA call spread: mua $475 / bán $485, tuần sau" · "ATM straddle trên SPY thứ Sáu này" · "2 AMZN puts, giới hạn $3.50" · "Bán AMZN260130P00200000"

execute_trade

Gửi bản nháp đến sàn môi giới sau khi người dùng đã xem xét.

  • Tham số: trade_id (số) — id của bản nháp từ create_trade hoặc create_options_trade.
  • Trả về: Giao dịch đã cập nhật; trạng thái "placed" hoặc "failed" (với chi tiết lỗi).

Chỉ gọi khi người dùng xác nhận rõ ràng (ví dụ: thực hiện, xác nhận, đặt lệnh, tiến hành). Xác nhận giao dịch khớp với những gì họ vừa xem xét.

Không gọi tự động ngay sau khi tạo bản nháp, khi chưa hiển thị chi tiết lệnh, hoặc khi trạng thái không phải "draft".

Tham khảo trạng thái giao dịch

Trạng tháiÝ nghĩa
draftĐã tạo; chưa gửi đến sàn môi giới
pendingĐã gửi; chờ xác nhận từ sàn môi giới
placedĐã chấp nhận; chờ khớp
partially_filledĐã khớp một phần
completeĐã khớp toàn bộ
canceledĐã hủy
failedBị từ chối — kiểm tra lỗi
disconnectedVấn đề kết nối sàn môi giới

ID môi giới (Trình trợ giúp API)

Sàn môi giớiIDQuyền chọn
Robinhood1Có
E*TRADE2Có
Coinbase3Chỉ tiền điện tử
Kraken5Chỉ tiền điện tử
Charles Schwab7Có
Webull8Có
Public11Có
Tastytrade12Có

Làm rõ: Hỏi một lần, với mọi thứ bạn cần, khi: loại lệnh không rõ ràng (ví dụ: “mua TSLA tại $200” — giới hạn vs dừng), quyền chọn thiếu ngày hết hạn/giá thực hiện, có nhiều tài khoản áp dụng và không có tài khoản nào được chọn, hoặc một ký hiệu có thể đại diện cho nhiều tài sản. Bỏ qua các câu hỏi thừa khi các mặc định rõ ràng (số tiền mặc định, lệnh thị trường, tài khoản chính).

Tuyên bố từ chối trách nhiệm

  • Đầu tư có rủi ro, bao gồm khả năng mất vốn gốc.
  • Trade It không phải là cố vấn tài chính và không cung cấp lời khuyên đầu tư.
  • Quyền chọn có rủi ro đáng kể và không phù hợp với tất cả nhà đầu tư.
  • Trade It không thể rút tiền, chuyển tài sản hoặc giữ quyền giám sát — nó chỉ có thể đặt lệnh qua các sàn môi giới đã liên kết của bạn.