Capital.com Public API MCP Server

Capital.com MCP Server

Máy chủ Model Context Protocol (MCP) cho Capital.com Open API - cho phép truy cập vào tài khoản giao dịch Capital.com của bạn thông qua LLM.

⚠️ Thông báo Quan trọng

Việc bạn sử dụng Capital.com Public API và bất kỳ công cụ bên thứ ba nào bạn kết nối với nó, bao gồm các công cụ AI hoặc dựa trên LLM, là do bạn tự quyết định và chịu rủi ro. Capital.com hoạt động trên cơ sở chỉ thực hiện lệnh và không kiểm soát, xác nhận hoặc chịu trách nhiệm pháp lý đối với bất kỳ phần mềm bên thứ ba nào, đầu ra của nó hoặc bất kỳ kết quả nào phát sinh. Không có nội dung nào trên trang này cấu thành lời khuyên đầu tư hoặc khuyến nghị giao dịch. Bạn hoàn toàn chịu trách nhiệm về mọi quyết định giao dịch, cấu hình và hoạt động tự động trên tài khoản của mình, và phải đảm bảo việc sử dụng của bạn tuân thủ Điều khoản và Điều kiện, Điều khoản Giao dịch Điện tử của Capital.com và tất cả các luật hiện hành tại khu vực pháp lý của bạn.

Sản phẩm Phái sinh Tiền điện tử không khả dụng cho khách hàng Bán lẻ đăng ký với Capital Com (UK) Ltd.

• Luôn bắt đầu với tài khoản Demo trước khi cân nhắc giao dịch thực
• Giao dịch bị vô hiệu hóa theo mặc định và yêu cầu cấu hình rõ ràng
• Tất cả các thao tác giao dịch yêu cầu thực hiện hai giai đoạn (xem trước → xác nhận → thực hiện)
• Kiểm soát rủi ro tích hợp: danh sách cho phép, giới hạn kích thước, giới hạn lệnh hàng ngày
• Sử dụng với rủi ro của riêng bạn - tác giả không chịu trách nhiệm pháp lý về tổn thất giao dịch

Đối với các câu hỏi/làm rõ thêm, vui lòng tham khảo Câu hỏi thường gặp: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Hướng dẫn Bắt đầu Nhanh

Bước 1: Lấy Thông tin Xác thực API Capital.com

1. Tạo Tài khoản: Truy cập capital.com/trading/signup

   • Chọn tài khoản Demo để thử nghiệm (khuyến nghị)
   • Xác minh email của bạn

2. Bật 2FA: Cài đặt > Bảo mật > Xác thực Hai yếu tố

   • Yêu cầu trước khi tạo khóa API

3. Tạo Khóa API: Cài đặt > Tích hợp API > Tạo khóa mới

   • Đặt nhãn (ví dụ: "MCP Server")
   • Đặt mật khẩu tùy chỉnh (đây KHÔNG phải là mật khẩu nền tảng của bạn)
   • Lưu khóa API được hiển thị (chỉ hiển thị một lần!)
   • Lưu ý: Khóa API có khả năng giao dịch; Capital.com không cung cấp khóa chỉ đọc

Bước 2: Cài đặt & Cấu hình

Bạn có hai tùy chọn cài đặt:

Tùy chọn A: Cài đặt Một chạm qua Gói MCPB (Khuyến nghị)

Kho lưu trữ đi kèm một manifest.json tuân thủ đặc tả MCPB (MCP Bundle) — tiêu chuẩn mở từ Anthropic để đóng gói máy chủ MCP cục bộ. Điều này cho phép bạn cài đặt máy chủ trong Claude Desktop (và các máy khách tương thích MCPB khác) mà không cần chỉnh sửa tệp cấu hình thủ công.

Điều kiện tiên quyết: uv (máy chủ sử dụng uv làm thời gian chạy — cài đặt với brew install uv hoặc xem tài liệu uv).

Các bước:

1. Sao chép kho lưu trữ và xây dựng gói .mcpb (yêu cầu Node.js cho npx):

   git clone https://github.com/capital-com-sv/capital-mcp.git
   cd capital-mcp
   npx @anthropic-ai/mcpb pack . capital-mcp.mcpb
   

2. Mở capital-mcp.mcpb trong Claude Desktop (nhấp đúp, hoặc kéo nó vào ứng dụng).
3. Claude Desktop sẽ nhắc bạn về các giá trị cấu hình người dùng (khóa API, mã định danh, mật khẩu, kiểm soát giao dịch). Điền chúng và nhấp vào Cài đặt.
4. Khởi động lại Claude Desktop và xác minh bằng cách hỏi: "Có những công cụ Capital.com nào khả dụng?"

Xem tham khảo CLI MCPB để biết các lệnh bổ sung (validate, info, unpack, sign).

Tùy chọn B: Cài đặt Thủ công qua Tập lệnh

Điều kiện tiên quyết: Python 3.10+ và Git phải được cài đặt.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (chọn "Add to PATH" trong khi cài đặt) + git-scm.com

Mac/Linux:

cd /path/to/capital-mcp
./install.sh

Windows (PowerShell):

cd C:\path\to\capital-mcp
pwsh install.ps1

Tập lệnh cài đặt sẽ tạo một môi trường ảo, cài đặt các phụ thuộc và in cấu hình máy khách MCP cho bạn.

Chỉnh sửa .env với thông tin xác thực của bạn:

# Required
CAP_ENV=demo
CAP_API_KEY=your_generated_api_key_here
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_api_password

# Trading controls (keep trading disabled until ready)
CAP_ALLOW_TRADING=false
CAP_ALLOWED_EPICS=

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

Bước 3: Kiểm tra Máy chủ Cục bộ

Mac/Linux:

source venv/bin/activate
python -m capital_mcp.server

Windows (PowerShell):

.\venv\Scripts\Activate.ps1
python -m capital_mcp.server

Bạn sẽ thấy:

INFO - Starting Capital.com MCP Server (env: demo)
INFO - Trading enabled: False

Nhấn Ctrl+C để dừng.

Khắc phục sự cố: Kiểm tra Nhật ký

Nếu bạn gặp sự cố khi sử dụng máy chủ MCP với Claude Desktop hoặc các máy khách khác, hãy kiểm tra các tệp nhật ký:

macOS:

# View MCP server logs
tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log

# Search for errors
grep -i error ~/Library/Logs/Claude/mcp-server-capital-com.log

Linux:

tail -f ~/.config/Claude/logs/mcp-server-capital-com.log

Windows:

Get-Content $env:APPDATA\Claude\logs\mcp-server-capital-com.log -Wait

---

Tích hợp

Lưu ý: Thay thế /path/to/capital-mcp/venv/bin/python bằng đường dẫn Python venv thực tế của bạn. Tập lệnh cài đặt in ra điều này cho bạn. Trên Windows, sử dụng C:\path\to\capital-mcp\venv\Scripts\python.exe.

Claude Desktop

💡 Mẹo: Nếu bạn đã cài đặt qua gói MCPB (Tùy chọn A ở trên), bỏ qua phần này — Claude Desktop tự động ghi cấu hình cho bạn dựa trên manifest.json. Chỉ sử dụng phần này cho cài đặt tập lệnh thủ công.

macOS/Linux

Vị trí cấu hình: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hoặc ~/.config/Claude/claude_desktop_config.json (Linux)

{
  "mcpServers": {
    "capital-com": {
      "command": "/path/to/capital-mcp/venv/bin/python",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "CAP_ENV": "demo",
        "CAP_API_KEY": "your_api_key_here",
        "CAP_IDENTIFIER": "your_email@example.com",
        "CAP_API_PASSWORD": "your_custom_password",
        "CAP_ALLOW_TRADING": "false",
        "CAP_ALLOWED_EPICS": ""
      }
    }
  }
}

Khởi động lại Claude Desktop. Xác minh bằng cách nhập: "Có những công cụ Capital.com nào khả dụng?"

Windows

Vị trí cấu hình: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "capital-com": {
      "command": "C:\\path\\to\\capital-mcp\\venv\\Scripts\\python.exe",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "CAP_ENV": "demo",
        "CAP_API_KEY": "your_api_key_here",
        "CAP_IDENTIFIER": "your_email@example.com",
        "CAP_API_PASSWORD": "your_custom_password",
        "CAP_ALLOW_TRADING": "false",
        "CAP_ALLOWED_EPICS": ""
      }
    }
  }
}

Khởi động lại Claude Desktop.

Claude Code

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

Cursor IDE

Mở Cài đặt (Cmd+, / Ctrl+,) > Tiện ích mở rộng > MCP > Cấu hình. Thêm:

{
  "capital-com": {
    "command": "/path/to/capital-mcp/venv/bin/python",
    "args": ["-m", "capital_mcp.server"],
    "env": {
      "CAP_ENV": "demo",
      "CAP_API_KEY": "your_api_key_here",
      "CAP_IDENTIFIER": "your_email@example.com",
      "CAP_API_PASSWORD": "your_custom_password",
      "CAP_ALLOW_TRADING": "false"
    }
  }
}

Khởi động lại Cursor.

Codex

Cài đặt > Máy chủ MCP > Thêm máy chủ. Sử dụng cùng lệnh, đối số và biến môi trường như trên.

Windsurf

Tạo/chỉnh sửa ~/.windsurf/mcp/servers.json:

{
  "mcpServers": {
    "capital-com": {
      "command": "/path/to/capital-mcp/venv/bin/python",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "CAP_ENV": "demo",
        "CAP_API_KEY": "your_api_key_here",
        "CAP_IDENTIFIER": "your_email@example.com",
        "CAP_API_PASSWORD": "your_custom_password"
      }
    }
  }
}

Khởi động lại Windsurf.

Máy khách MCP Tùy chỉnh

Bất kỳ máy khách MCP có khả năng STDIO nào cũng hoạt động. Ví dụ với Node.js:

import { spawn } from 'child_process';

const server = spawn('/path/to/venv/bin/python', ['-m', 'capital_mcp.server'], {
  env: {
    ...process.env,
    CAP_ENV: 'demo',
    CAP_API_KEY: 'your_key',
    CAP_IDENTIFIER: 'your_email',
    CAP_API_PASSWORD: 'your_password',
    CAP_ALLOW_TRADING: 'false'
  }
});

// Communicate via STDIO (JSON-RPC)
// Read from server.stdout, write to server.stdin

Ví dụ Sử dụng

Ví dụ Hội thoại với Claude Desktop

You: "Check my Capital.com session status"

Claude: I'll check your session status.
[Calls cap_session_status]
Response: {"ok": true, "data": {"env": "demo", "logged_in": false, ...}}

You're not currently logged in to the demo environment.

---

You: "Login to my Capital.com account"

Claude: I'll log you in.
[Calls cap_session_login]
Success! Logged in to account ID: ABC123

---

You: "Search for Bitcoin markets"

Claude: Searching for Bitcoin...
[Calls cap_market_search with search_term="Bitcoin"]
Found 5 markets:
- BTCUSD: Bitcoin vs US Dollar
- BTCEUR: Bitcoin vs Euro
- BTCGBP: Bitcoin vs British Pound
...

---

You: "Show me current positions"

Claude: Let me check your positions.
[Calls cap_trade_positions_list]
You have no open positions.

---

You: "Preview buying 1.0 SILVER"

Claude: I'll preview this trade. Note: Trading is currently DISABLED.
[Calls cap_trade_preview_position]
Preview failed: Trading is disabled (CAP_ALLOW_TRADING=false)

To enable trading, update your .env file:
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=SILVER

Quy trình Thực hiện Giao dịch (Khi Giao dịch được Bật)

1. Preview the trade (validates everything, no side effects):
   "Preview buying 2.0 SILVER with stop at 24.50"
   → Returns preview_id

2. Review the preview results:
   - Normalized size (rounded to broker increments)
   - Risk checks (allowlist, size limits, daily limits)
   - Estimated entry price

3. Execute ONLY if all checks pass:
   "Execute position with preview_id [id], confirm=true"
   → Creates real position
   → Returns deal_reference
   → Polls for broker confirmation

4. Monitor:
   "Show my positions"
   "Close position [deal_id] with confirm=true"

Tham khảo Biến Môi trường

Bắt buộc

• CAP_ENV - Môi trường: demo hoặc live (mặc định: demo)
• CAP_API_KEY - Khóa API từ Capital.com
• CAP_IDENTIFIER - Email đăng nhập
• CAP_API_PASSWORD - Mật khẩu tùy chỉnh khóa API

Kiểm soát Rủi ro (Khuyến nghị)

• CAP_ALLOW_TRADING - Bật giao dịch (mặc định: false)
• CAP_ALLOWED_EPICS - Danh sách cho phép phân cách bằng dấu phẩy (ví dụ: "SILVER,GOLD,BTCUSD") hoặc "ALL" để không hạn chế
• CAP_MAX_POSITION_SIZE - Kích thước vị thế tối đa (mặc định: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Kích thước lệnh tối đa (mặc định: 1.0)
• CAP_MAX_OPEN_POSITIONS - Số vị thế đồng thời tối đa (mặc định: 3)
• CAP_MAX_ORDERS_PER_DAY - Giới hạn lệnh hàng ngày (mặc định: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Yêu cầu confirm=true (mặc định: true)
• CAP_DRY_RUN - Chặn tất cả thực thi giao dịch (mặc định: false)

Tùy chọn

• CAP_DEFAULT_ACCOUNT_ID - Tài khoản mặc định sau khi đăng nhập
• CAP_HTTP_TIMEOUT_S - Thời gian chờ HTTP (mặc định: 15)
• CAP_LOG_LEVEL - Mức nhật ký: DEBUG, INFO, WARNING, ERROR (mặc định: INFO)

Công cụ MCP (36 đã triển khai)

Phiên (4)

• cap_session_status - Lấy thông tin phiên
• cap_session_login - Tạo phiên
• cap_session_ping - Duy trì kết nối
• cap_session_logout - Kết thúc phiên

Dữ liệu Thị trường (6)

• cap_market_search - Tìm kiếm thị trường
• cap_market_get - Lấy chi tiết thị trường
• cap_market_prices - Giá lịch sử
• cap_market_sentiment - Tâm lý khách hàng
• cap_market_navigation_root - Gốc danh mục thị trường
• cap_market_navigation_node - Nút danh mục thị trường

Tài khoản (6)

• cap_account_list - Liệt kê tài khoản
• cap_account_preferences_get - Lấy tùy chọn
• cap_account_preferences_set - Đặt tùy chọn
• cap_account_history_activity - Lịch sử hoạt động
• cap_account_history_transactions - Lịch sử giao dịch
• cap_account_demo_topup - Nạp tiền tài khoản demo

Giao dịch (11)

• Chỉ đọc:

  • cap_trade_positions_list - Liệt kê vị thế
  • cap_trade_positions_get - Lấy chi tiết vị thế
  • cap_trade_orders_list - Liệt kê lệnh đang hoạt động
  • cap_trade_confirm_get - Lấy trạng thái xác nhận
  • cap_trade_confirm_wait - Chờ xác nhận

• Xem trước:

  • cap_trade_preview_position - Xem trước vị thế
  • cap_trade_preview_working_order - Xem trước lệnh

• Thực hiện:

  • cap_trade_execute_position - Thực hiện vị thế
  • cap_trade_execute_working_order - Thực hiện lệnh
  • cap_trade_positions_close - Đóng vị thế
  • cap_trade_orders_cancel - Hủy lệnh

Danh sách theo dõi (6)

• cap_watchlists_list - Liệt kê danh sách theo dõi
• cap_watchlists_create - Tạo danh sách theo dõi
• cap_watchlists_get - Lấy danh sách theo dõi
• cap_watchlists_add_market - Thêm thị trường
• cap_watchlists_delete - Xóa danh sách theo dõi
• cap_watchlists_remove_market - Xóa thị trường

Phát trực tuyến (3)

• cap_stream_prices - Phát giá thời gian thực (WebSocket)
• cap_stream_alerts - Phát cảnh báo mức giá (WebSocket)
• cap_stream_portfolio - Phát P&L danh mục đầu tư trực tiếp (WebSocket)

Lời nhắc MCP (Mẫu Quy trình)

Lời nhắc MCP là các quy trình có cấu trúc hướng dẫn Claude thông qua các thao tác giao dịch phức tạp nhiều bước. Chúng cung cấp hướng dẫn từng bước và các phương pháp hay nhất cho các tác vụ phổ biến.

Lời nhắc Khả dụng (7)

1. market_scan - Quy trình Phân tích Thị trường

Hướng dẫn bạn quét danh sách theo dõi để tìm điều kiện giao dịch.

Tham số:

• watchlist_id - Danh sách theo dõi để quét (để trống để liệt kê danh sách theo dõi trước)
• timeframe - Độ phân giải giá: MINUTE, MINUTE_5, HOUR, DAY (mặc định: HOUR)
• lookback_periods - Số lượng nến cần lấy: 1-1000 (mặc định: 24)

Quy trình:

1. Lấy thị trường trong danh sách theo dõi
2. Lấy dữ liệu giá cho từng thị trường
3. Phân tích kỹ thuật (xu hướng, hỗ trợ/kháng cự, mẫu hình)
4. Kiểm tra tâm lý tùy chọn
5. Tạo tóm tắt cơ hội

Ví dụ Sử dụng:

• "Sử dụng lời nhắc market_scan để phân tích danh sách theo dõi của tôi"
• "Quét thị trường của tôi để tìm thiết lập giao dịch"

Giao dịch thực: Thay đổi cấu hình của bạn thành: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - Quy trình Lập kế hoạch Giao dịch

Hướng dẫn bạn tạo đề xuất giao dịch với các công cụ quản lý rủi ro.

Tham số:

• epic - Thị trường để giao dịch (bắt buộc, ví dụ: SILVER, GOLD)
• direction - MUA hoặc BÁN (mặc định: BUY)
• thesis - Lý do giao dịch của bạn (tùy chọn)
• risk_percent - Rủi ro theo % số dư (mặc định: 1.0%)

Quy trình:

1. Lấy chi tiết thị trường và quy tắc giao dịch
2. Tính toán kích thước vị thế dựa trên % rủi ro
3. Xác định mức cắt lỗ và chốt lời
4. Xem trước giao dịch (chỉ xác thực - không thực hiện)
5. Trả về preview_id để thực hiện tiềm năng

Ví dụ Sử dụng:

• "Tạo đề xuất giao dịch cho SILVER"
• "Đề xuất giao dịch mua GOLD với 2% rủi ro"

Lưu ý: Lời nhắc này KHÔNG thực hiện giao dịch - nó chỉ tạo bản xem trước.

3. execute_trade - Quy trình Thực hiện Giao dịch

Hướng dẫn bạn thực hiện một giao dịch đã xem trước.

Tham số:

• preview_id - ID xem trước từ trade_proposal (bắt buộc)

Quy trình:

1. Xác minh preview_id được cung cấp và hợp lệ
2. Kiểm tra lại tất cả các kiểm soát rủi ro
3. Thực hiện vị thế với nhà môi giới
4. Thăm dò để xác nhận (CHẤP NHẬN/TỪ CHỐI)
5. Báo cáo trạng thái cuối cùng

Ví dụ Sử dụng:

• "Thực hiện giao dịch tôi vừa xem trước"
• "Đặt giao dịch với ID xem trước abc-123"

Lưu ý:

• Yêu cầu CAP_ALLOW_TRADING=true
• Yêu cầu epic trong danh sách cho phép
• Bản xem trước không được hết hạn (TTL 2 phút)
• ⚠️ Điều này SẼ đặt một giao dịch thực

4. position_review - Quy trình Phân tích Danh mục Đầu tư

Hướng dẫn bạn phân tích các vị thế và lệnh đang mở của bạn.

Tham số: Không có (phân tích tất cả các vị thế hiện tại)

Quy trình:

1. Lấy tất cả các vị thế đang mở
2. Lấy tất cả các lệnh đang hoạt động
3. Tính toán P&L, rủi ro và các chỉ số tiếp xúc
4. Xác định rủi ro tập trung và tương quan
5. Đề xuất các điều chỉnh tiềm năng (không thực hiện)

Ví dụ Sử dụng:

• "Xem xét các vị thế hiện tại của tôi"
• "Phân tích mức độ tiếp xúc danh mục đầu tư của tôi"

Lưu ý: Đây là quy trình chỉ đọc - không có giao dịch nào được thực hiện.

5. live_price_monitor - Theo dõi Giá Thời gian Thực (WebSocket)

Giám sát giá thị trường trực tiếp với cảnh báo tức thì khi giá di chuyển vượt ngưỡng.

Tham số:

• epics - Danh sách EPIC thị trường để giám sát (để trống để tìm kiếm/chọn, tối đa 40)
• duration_minutes - Thời gian giám sát (mặc định: 5 phút, tối đa: 10 phút)
• threshold_percent - Cảnh báo khi giá di chuyển > % này (mặc định: 1.0%)

Quy trình:

1. Chọn thị trường để giám sát (hoặc cung cấp trực tiếp EPIC)
2. Lấy giá ban đầu để thiết lập đường cơ sở
3. Đăng ký cập nhật giá WebSocket thời gian thực
4. Hiển thị bảng giá trực tiếp với cập nhật liên tục
5. Cảnh báo khi bất kỳ thị trường nào di chuyển > threshold_percent
6. Tự động dừng sau duration_minutes

Ví dụ Sử dụng:

• "Giám sát giá GOLD và SILVER trong 2 phút"
• "Theo dõi BTC trong 5 phút tới, cảnh báo khi biến động 2%" Lưu ý: Yêu cầu CAP_WS_ENABLED=true. Phiên WebSocket của Capital.com kéo dài tối đa 10 phút.

6. real_time_alerts - Cảnh báo Giá có Điều kiện (WebSocket)

Thiết lập cảnh báo mức giá và nhận thông báo tức thì khi thị trường chạm mục tiêu của bạn.

Tham số:

• alert_config - Các mức cảnh báo cho mỗi EPIC (ví dụ: {"GOLD": 2050.0, "SILVER": 28.5})
• duration_minutes - Thời lượng theo dõi tối đa (mặc định: 5 phút)
• auto_stop - Dừng theo dõi sau cảnh báo đầu tiên? (mặc định: true)

Quy trình làm việc:

1. Cấu hình điều kiện cảnh báo (mức giá cho mỗi thị trường)
2. Đăng ký cập nhật giá qua WebSocket
3. Theo dõi liên tục các kích hoạt cảnh báo
4. Phát cảnh báo tức thì khi điều kiện được đáp ứng
5. Tùy chọn tiếp tục theo dõi hoặc dừng sau cảnh báo đầu tiên

Ví dụ Sử dụng:

• "Cảnh báo cho tôi khi VÀNG đạt 2050"
• "Thông báo khi BẠC giảm xuống dưới 28"

Lưu ý: Yêu cầu CAP_WS_ENABLED=true.

7. live_portfolio_monitor - Theo dõi Lãi/Lỗ Thời gian Thực (WebSocket)

Theo dõi Lãi/Lỗ danh mục đầu tư của bạn cập nhật theo thời gian thực khi giá thị trường biến động.

Tham số:

• duration_minutes - Thời lượng theo dõi (mặc định: 5 phút, tối đa: 10 phút)
• alert_pnl_threshold - Cảnh báo khi tổng Lãi/Lỗ vượt quá số tiền này (mặc định: $100)

Quy trình làm việc:

1. Lấy các vị thế mở hiện tại
2. Đăng ký cập nhật giá cho các thị trường có vị thế
3. Tính toán Lãi/Lỗ trực tiếp khi giá thay đổi
4. Hiển thị bảng điều khiển danh mục đầu tư thời gian thực
5. Cảnh báo khi Lãi/Lỗ vượt ngưỡng

Ví dụ Sử dụng:

• "Theo dõi Lãi/Lỗ danh mục đầu tư của tôi trong 5 phút"
• "Xem vị thế theo thời gian thực, cảnh báo khi Lãi/Lỗ đạt $500"

Lưu ý: Yêu cầu CAP_WS_ENABLED=true và các vị thế đang hoạt động.

Cách Sử dụng Prompt

Trong Claude Desktop hoặc các máy khách MCP khác, prompt xuất hiện dưới dạng các mẫu tương tác có sẵn. Bạn có thể gọi chúng một cách tự nhiên trong hội thoại:

User: "I want to scan my watchlist for opportunities"
Claude: [Invokes market_scan prompt, guides through the workflow]

User: "Create a trade plan for SILVER"
Claude: [Invokes trade_proposal prompt, designs trade with risk management]

User: "Execute that trade"
Claude: [Invokes execute_trade prompt, submits to broker]

User: "Show me my open positions"
Claude: [Invokes position_review prompt, analyzes portfolio]

Prompt cung cấp hướng dẫn có cấu trúc trong khi vẫn duy trì các kiểm soát giao dịch trong suốt quy trình làm việc.

Tài nguyên MCP (Dữ liệu Chỉ đọc)

Tài nguyên MCP cung cấp quyền truy cập chỉ đọc vào trạng thái và cấu hình máy chủ thông qua các tài nguyên dựa trên URI. Không giống như công cụ (thực hiện hành động), tài nguyên hiển thị dữ liệu mà máy khách có thể đọc và giám sát.

Tài nguyên Có sẵn

1. cap://status - Trạng thái Máy chủ

Thông tin máy chủ và phiên làm việc theo thời gian thực.

Trả về: JSON với tình trạng máy chủ, trạng thái phiên, trạng thái xác thực, giới hạn tốc độ

Ví dụ:

{
  "server": {
    "name": "Capital.com MCP Server",
    "version": "0.1.0",
    "trading_enabled": true
  },
  "session": {
    "logged_in": true,
    "account_id": "ABC123",
    "last_used_at": "2026-01-16T10:30:00Z",
    "expires_in_s_estimate": 522
  },
  "risk": {
    "trading_enabled": true,
    "allowed_epics": ["GOLD", "SILVER"],
    "allowlist_mode": "SPECIFIC"
  },
  "rate_limits": {
    "requests_per_second": "10",
    "note": "Capital.com enforces 10 req/s limit"
  }
}

Trường hợp Sử dụng: Giám sát tình trạng máy chủ, kiểm tra trạng thái phiên, gỡ lỗi vấn đề xác thực

---

2. cap://risk-policy - Chính sách Rủi ro

Cấu hình quản lý rủi ro toàn diện và các kiểm soát giao dịch.

Trả về: JSON với tất cả các lớp xác thực, tính năng kiểm soát giao dịch và hạn chế giao dịch

Ví dụ:

{
  "trading_enabled": true,
  "two_phase_execution": true,
  "description": "All trades require preview → explicit execution",
  "allowlist": {
    "mode": "SPECIFIC",
    "epics": ["GOLD", "SILVER"],
    "note": "Only markets on this list can be traded (ALL = wildcard)"
  },
  "validation_layers": [
    "1. Trading enabled check (TRADING_ENABLED env var)",
    "2. Epic allowlist check (must be in ALLOWED_EPICS)",
    "... 10 total layers ..."
  ],
  "execution_controls": {
    "preview_required": true,
    "deal_reference_matching": true,
    "authentication_required": true,
    "rate_limiting": true,
    "input_validation": true
  }
}

Trường hợp Sử dụng: Hiểu các kiểm soát giao dịch đang hoạt động, kiểm tra cấu hình rủi ro, tài liệu tuân thủ

---

3. cap://allowed-epics - Danh sách Cho phép Giao dịch

Cấu hình danh sách cho phép giao dịch hiện tại hiển thị các thị trường được phép.

Trả về: JSON với chế độ danh sách cho phép, các epic được phép và hướng dẫn cấu hình

Ví dụ:

{
  "mode": "SPECIFIC",
  "allowed_epics": ["GOLD", "SILVER", "BTCUSD"],
  "count": 3,
  "trading_enabled": true,
  "description": "Restricted mode: 3 specific markets allowed",
  "configuration": {
    "env_var": "ALLOWED_EPICS",
    "example": "ALLOWED_EPICS=GOLD,SILVER,BTCUSD",
    "wildcard": "ALLOWED_EPICS=ALL (allows all markets)"
  }
}

Trường hợp Sử dụng: Kiểm tra thị trường nào có thể giao dịch, xác minh cấu hình danh sách cho phép

---

4. cap://market-cache/{epic} - Chi tiết Thị trường (Động)

Chi tiết thị trường được lưu trong bộ nhớ đệm cho một epic cụ thể (tìm nạp trực tiếp từ nhà môi giới).

Tham số:

• epic - Mã định danh thị trường (ví dụ: "GOLD", "SILVER", "CS.D.EURUSD.TODAY.IP")

Trả về: JSON với thông tin thị trường toàn diện

Xác thực: Bắt buộc

Ví dụ: cap://market-cache/GOLD

{
  "epic": "GOLD",
  "instrument_name": "Spot Gold",
  "instrument_type": "COMMODITIES",
  "currency": "USD",
  "snapshot": {
    "market_status": "TRADEABLE",
    "bid": 2050.50,
    "offer": 2050.75,
    "update_time": "2026-01-16T10:30:00"
  },
  "dealing": {
    "min_size": 0.1,
    "max_size": 100.0,
    "min_step": 0.1,
    "min_stop_distance": 5.0
  },
  "margin": {
    "factor": 5.0,
    "unit": "PERCENTAGE"
  },
  "opening_hours": {...},
  "cached_at": "2026-01-16T10:30:00"
}

Trường hợp Sử dụng: Lấy chi tiết thị trường, kiểm tra quy tắc giao dịch, phân tích yêu cầu ký quỹ

---

Cách Sử dụng Tài nguyên

Trong Claude Desktop hoặc các máy khách MCP khác, tài nguyên có thể được truy cập bằng URI:

User: "Show me the server status"
Claude: [Reads cap://status resource, displays server health]

User: "What's the risk policy?"
Claude: [Reads cap://risk-policy resource, explains trading controls]

User: "Which markets can I trade?"
Claude: [Reads cap://allowed-epics resource, lists permitted epics]

User: "Show all my watchlists"
Claude: [Calls cap_watchlists_list tool, displays watchlist data]

User: "Get details for GOLD market"
Claude: [Reads cap://market-cache/GOLD resource, shows market info]

Tài nguyên cung cấp cách thuận tiện để kiểm tra trạng thái và cấu hình máy chủ mà không cần chạy công cụ. Đối với dữ liệu danh sách theo dõi, hãy sử dụng các công cụ cap_watchlists_list và cap_watchlists_get.

Quy trình Thực hiện Giao dịch

Thực hiện Hai bước Bắt buộc

Tất cả các thao tác có tác dụng phụ đều sử dụng quy trình xem trước → thực hiện nghiêm ngặt:

1. Xem trước: Xác thực giao dịch dựa trên quy tắc nhà môi giới + chính sách rủi ro cục bộ

   • Trả về preview_id với yêu cầu đã chuẩn hóa + kiểm tra rủi ro
   • Không có tác dụng phụ, chỉ xác thực đọc

2. Thực hiện: Gửi giao dịch bằng preview_id

   • Chạy lại các kiểm tra quan trọng
   • Yêu cầu confirm=true nếu CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Thăm dò xác nhận từ nhà môi giới
   • Tăng bộ đếm lệnh hàng ngày

Kiểm soát Rủi ro

• Danh sách Cho phép: Chỉ các EPIC trong CAP_ALLOWED_EPICS mới có thể được giao dịch
• Giới hạn Kích thước: Kích thước vị thế/lệnh tối đa được thực thi
• Giới hạn Vị thế: Số vị thế mở tối đa tại bất kỳ thời điểm nào
• Giới hạn Hàng ngày: Số lệnh tối đa mỗi ngày
• Chuẩn hóa Kích thước: Làm tròn đến mức tối thiểu/tối đa/bước tăng của nhà môi giới
• Chế độ Chạy Thử: Chặn tất cả các thực thi khi được bật

Tài liệu

• Hướng dẫn Sử dụng: USAGE.md - Hướng dẫn sử dụng toàn diện với các ví dụ
• Tham khảo API Capital.com: https://open-api.capital.com/
• Bộ sưu tập Postman API Capital.com: https://github.com/capital-com-sv/capital-api-postman

Giấy phép

MIT

Tuyên bố Từ chối Trách nhiệm – Sử dụng API Công khai của Capital.com với Công cụ Bên thứ ba

Tích hợp Bên thứ ba

Trang này mô tả cách khách hàng có thể kết nối API Công khai của Capital.com với phần mềm, công cụ hoặc tích hợp của bên thứ ba, bao gồm cả những thứ được hỗ trợ bởi trí tuệ nhân tạo hoặc mô hình ngôn ngữ lớn ('LLM'). Bất kỳ phần mềm, công cụ hoặc tích hợp nào của bên thứ ba như vậy đều độc lập với Capital.com và không phải là một phần của các dịch vụ của Capital.com. Capital.com không kiểm soát, phát triển, xác nhận hoặc chấp nhận bất kỳ trách nhiệm pháp lý nào đối với bất kỳ phần mềm bên thứ ba nào, chức năng, đầu ra của nó hoặc bất kỳ kết quả nào phát sinh từ việc sử dụng nó. Bất kỳ việc sử dụng công cụ hoặc tích hợp của bên thứ ba nào liên quan đến API Công khai của Capital.com đều hoàn toàn do bạn tự chịu rủi ro. Bạn có trách nhiệm xem xét các điều khoản, chính sách bảo mật và thực tiễn xử lý dữ liệu của bất kỳ công cụ bên thứ ba nào bạn chọn sử dụng.

Sử dụng API Công khai

Việc bạn sử dụng API Công khai của Capital.com hoàn toàn theo quyết định và rủi ro của riêng bạn. Capital.com cung cấp API Công khai cho mục đích thông tin và giao dịch nhưng không khuyến nghị, xác nhận hoặc khuyến khích bất kỳ mục đích sử dụng, tích hợp hoặc chiến lược giao dịch cụ thể nào. Bạn hoàn toàn chịu trách nhiệm về cách bạn truy cập và sử dụng API, bao gồm các tham số của bất kỳ lệnh nào được gửi, cấu hình của bất kỳ công cụ hoặc hệ thống được kết nối nào và việc diễn giải bất kỳ dữ liệu nào nhận được. Capital.com không chấp nhận trách nhiệm pháp lý đối với các tổn thất hoặc kết quả không mong muốn phát sinh từ việc bạn sử dụng API, dù truy cập trực tiếp hay thông qua các công cụ của bên thứ ba. Tính khả dụng, chức năng và thông số kỹ thuật của API có thể được sửa đổi, giới hạn tốc độ, tạm ngừng hoặc ngừng cung cấp bất kỳ lúc nào mà không cần thông báo trước. Việc bạn sử dụng API Công khai phải tuân theo Điều khoản và Điều kiện và Điều khoản Giao dịch Điện tử của Capital.com, bạn nên đọc kỹ trước khi sử dụng API.

Dịch vụ Chỉ Thực hiện và Không có Tư vấn Đầu tư Capital.com cung cấp dịch vụ của mình trên cơ sở chỉ thực hiện. Giao dịch các công cụ tài chính có rủi ro thua lỗ đáng kể. Không có nội dung nào trên trang này, trong API Công khai hoặc trong bất kỳ phần mềm hoặc tích hợp nào của bên thứ ba cấu thành tư vấn đầu tư, khuyến nghị cá nhân hoặc chào mời mua hoặc bán bất kỳ công cụ tài chính nào. Điều này bao gồm bất kỳ đầu ra, tín hiệu, đề xuất hoặc phân tích nào được tạo ra bởi AI, các công cụ dựa trên LLM hoặc các công cụ tự động khác. Tất cả các quyết định giao dịch, bao gồm bất kỳ hoạt động tự động hoặc thuật toán nào, đều do bạn tự chịu rủi ro và vẫn là trách nhiệm duy nhất của bạn. Rủi ro của Giao dịch Tự động và Thuật toán Việc sử dụng API Công khai liên quan đến các công cụ giao dịch tự động hoặc thuật toán mang theo các rủi ro bổ sung, bao gồm nhưng không giới hạn ở: thực hiện lệnh nhanh chóng mà không có sự xem xét hoặc can thiệp của con người; lỗi hệ thống, lỗi phần mềm hoặc sự cố kết nối; thực hiện ở mức giá khác biệt đáng kể so với dự kiến; và các lệnh không mong muốn hoặc sai sót do cấu hình sai công cụ hoặc tham số. Capital.com không chịu trách nhiệm cho bất kỳ tổn thất nào phát sinh từ những rủi ro đó hoặc từ sự tương tác giữa hệ thống của mình và bất kỳ công cụ bên thứ ba nào. Hiệu suất trong quá khứ và bất kỳ đầu ra nào được tạo ra bởi các công cụ tự động không chỉ báo cho kết quả trong tương lai.

Sử dụng Bị Cấm

Việc sử dụng API Công khai và bất kỳ công cụ được kết nối nào không được sử dụng để thao túng nền tảng Capital.com, khai thác giá hoặc độ trễ, tham gia lạm dụng thị trường hoặc đạt được bất kỳ lợi thế không công bằng nào. Capital.com bảo lưu quyền hạn chế, tạm ngừng hoặc chấm dứt quyền truy cập API và/hoặc tài khoản của bạn khi họ có cơ sở hợp lý để cho rằng việc sử dụng sai mục đích đó đã xảy ra hoặc có khả năng xảy ra. Khách hàng không được phép cho bất kỳ bên thứ ba nào thực hiện quyền kiểm soát tùy ý đối với tài khoản của mình.

Trách nhiệm của Bạn

Bạn có trách nhiệm đảm bảo rằng việc bạn sử dụng nền tảng Capital.com, API Công khai và bất kỳ công cụ hoặc tích hợp nào của bên thứ ba tuân thủ Điều khoản và Điều kiện, Điều khoản Giao dịch Điện tử của Capital.com và tất cả các luật và quy định hiện hành tại khu vực pháp lý của bạn. Bạn nên cân nhắc kỹ lưỡng xem các công cụ giao dịch tự động có phù hợp với hoàn cảnh, kinh nghiệm và khả năng chấp nhận rủi ro của bạn hay không trước khi sử dụng chúng. Capital.com đặc biệt khuyến nghị bạn nên kiểm tra kỹ lưỡng bất kỳ công cụ hoặc tích hợp tự động nào bằng tài khoản Demo trước khi kết nối chúng với môi trường giao dịch thực.