Capital.com Public API MCP Server

ทางการ

เซิร์ฟเวอร์ Capital.com MCP ช่วยให้ผู้ช่วย AI ของคุณสามารถสื่อสารกับบัญชีซื้อขายของคุณได้โดยตรง ข้อมูลตลาด การตรวจสอบสถานะ การแสดงตัวอย่างการซื้อขาย – ทั้งหมดนี้เป็นภาษาที่เข้าใจง่าย โดยไม่ต้องออกจากเครื่องมือ AI ของคุณ

คุณทำอะไรได้บ้างด้วย Capital Com Public API MCP?

  • ตรวจสอบสถานะเซสชันและเข้าสู่ระบบ — ให้ผู้ช่วยตรวจสอบการเชื่อมต่อและยืนยันตัวตนของคุณโดยใช้ cap_session_status และ cap_session_login
  • ค้นหาและตรวจสอบตลาด — ค้นหาเครื่องมือ เช่น "Bitcoin" หรือ "GOLD" ด้วย cap_market_search จากนั้นดึงข้อมูลรายละเอียด ราคาประวัติ หรือความรู้สึกของลูกค้า
  • ดูตัวอย่างและดำเนินการเทรดพร้อมการควบคุมความเสี่ยง — ดูตัวอย่างสถานะผ่าน cap_trade_preview_position ตรวจสอบขนาดที่ปรับมาตรฐานและการตรวจสอบ จากนั้นดำเนินการด้วย cap_trade_execute_position (ต้องใช้ confirm=true)
  • ติดตามสถานะและคำสั่งที่กำลังทำงาน — แสดงรายการสถานะที่เปิดอยู่ด้วย cap_trade_positions_list ตรวจสอบสถานะคำสั่ง และปิดหรือยกเลิกตามต้องการ
  • จัดการรายการเฝ้าดู — สร้าง ดู และอัปเดตรายการเฝ้าดูโดยใช้ cap_watchlists_create, cap_watchlists_add_market และเครื่องมือที่เกี่ยวข้อง
  • สตรีมราคาแบบเรียลไทม์และ P&L ของพอร์ตโฟลิโอ — สมัครรับข้อมูลอัปเดตราคาสดผ่าน cap_stream_prices หรือติดตาม P&L ของพอร์ตโฟลิโอด้วย cap_stream_portfolio (WebSocket)

เอกสาร

Capital.com MCP Server

Model Context Protocol (MCP) server สำหรับ Capital.com Open API - ช่วยให้ LLM เข้าถึงบัญชีเทรด Capital.com ของคุณได้

⚠️ ประกาศสำคัญ

การใช้งาน Capital.com Public API และเครื่องมือของบุคคลที่สามใดๆ ที่คุณเชื่อมต่อ รวมถึงเครื่องมือ AI หรือ LLM ถือเป็นดุลยพินิจและความเสี่ยงของคุณเอง Capital.com ดำเนินการบนพื้นฐาน execution-only เท่านั้น และไม่ได้ควบคุม รับรอง หรือยอมรับความรับผิดต่อซอฟต์แวร์ของบุคคลที่สาม ผลลัพธ์ หรือผลลัพธ์ใดๆ ที่เกิดขึ้น เนื้อหาในหน้านี้ไม่ถือเป็นคำแนะนำในการลงทุนหรือคำแนะนำในการเทรด คุณเป็นผู้รับผิดชอบแต่เพียงผู้เดียวสำหรับการตัดสินใจเทรด การกำหนดค่า และกิจกรรมอัตโนมัติทั้งหมดในบัญชีของคุณ และต้องตรวจสอบให้แน่ใจว่าการใช้งานของคุณเป็นไปตามข้อกำหนดและเงื่อนไขของ Capital.com ข้อกำหนดการเทรดทางอิเล็กทรอนิกส์ และกฎหมายที่เกี่ยวข้องทั้งหมดในเขตอำนาจศาลของคุณ

Crypto Derivatives ไม่สามารถใช้ได้สำหรับลูกค้ารายย่อยที่ลงทะเบียนกับ Capital Com (UK) Ltd.

  • เริ่มต้นด้วย บัญชี Demo ทุกครั้งก่อนพิจารณาการเทรดจริง
  • การเทรดถูก ปิดใช้งานโดยค่าเริ่มต้น และต้องมีการกำหนดค่าอย่างชัดเจน
  • การดำเนินการเทรดทั้งหมดต้องใช้ การดำเนินการสองขั้นตอน (ดูตัวอย่าง → ยืนยัน → ดำเนินการ)
  • การควบคุมความเสี่ยงในตัว: รายการที่อนุญาต, ขีดจำกัดขนาด, ขีดจำกัดคำสั่งรายวัน
  • ใช้ด้วยความเสี่ยงของคุณเอง - ผู้เขียนไม่รับผิดชอบต่อการขาดทุนจากการเทรด

สำหรับคำถาม/คำชี้แจงเพิ่มเติม โปรดดูคำถามที่พบบ่อย: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

คู่มือเริ่มต้นอย่างรวดเร็ว

ขั้นตอนที่ 1: รับข้อมูลรับรอง Capital.com API

  1. สร้างบัญชี: ไปที่ capital.com/trading/signup

    • เลือกบัญชี Demo สำหรับการทดสอบ (แนะนำ)
    • ยืนยันอีเมลของคุณ
  2. เปิดใช้งาน 2FA: การตั้งค่า > ความปลอดภัย > การยืนยันตัวตนสองขั้นตอน

    • จำเป็นก่อนสร้างคีย์ API
  3. สร้างคีย์ API: การตั้งค่า > การผสานรวม API > สร้างคีย์ใหม่

    • ตั้งป้ายกำกับ (เช่น "MCP Server")
    • ตั้งรหัสผ่านที่กำหนดเอง (นี่ไม่ใช่รหัสผ่านแพลตฟอร์มของคุณ)
    • บันทึกคีย์ API ที่แสดง (แสดงเพียงครั้งเดียวเท่านั้น!)
    • หมายเหตุ: คีย์ API สามารถใช้เทรดได้ Capital.com ไม่มีคีย์แบบอ่านอย่างเดียว

ขั้นตอนที่ 2: ติดตั้งและกำหนดค่า

คุณมีสองตัวเลือกในการติดตั้ง:

ตัวเลือก A: ติดตั้งในคลิกเดียวผ่าน MCPB Bundle (แนะนำ)

repo มาพร้อมกับ manifest.json ที่สอดคล้องกับ ข้อกำหนด MCPB (MCP Bundle) — มาตรฐานเปิดจาก Anthropic สำหรับการแพ็คเกจ MCP server ในเครื่อง ซึ่งช่วยให้คุณติดตั้ง server ใน Claude Desktop (และไคลเอนต์ที่เข้ากันได้กับ MCPB อื่นๆ) โดยไม่ต้องแก้ไขไฟล์กำหนดค่าด้วยตนเอง

ข้อกำหนดเบื้องต้น: uv (server ใช้ uv เป็นรันไทม์ — ติดตั้งด้วย brew install uv หรือดู เอกสาร uv)

ขั้นตอน:

  1. โคลน repo และสร้าง .mcpb bundle (ต้องใช้ Node.js สำหรับ npx):
    git clone https://github.com/capital-com-sv/capital-mcp.git
    cd capital-mcp
    npx @anthropic-ai/mcpb pack . capital-mcp.mcpb
    
  2. เปิด capital-mcp.mcpb ใน Claude Desktop (ดับเบิลคลิก หรือลากลงในแอป)
  3. Claude Desktop จะถามค่ากำหนดค่าผู้ใช้ (คีย์ API, ตัวระบุ, รหัสผ่าน, การควบคุมการเทรด) กรอกข้อมูลและคลิก Install
  4. รีสตาร์ท Claude Desktop และตรวจสอบโดยถามว่า: "มีเครื่องมือ Capital.com อะไรบ้างที่พร้อมใช้งาน?"

ดู ข้อมูลอ้างอิง MCPB CLI สำหรับคำสั่งเพิ่มเติม (validate, info, unpack, sign)

ตัวเลือก B: ติดตั้งด้วยตนเองผ่านสคริปต์

ข้อกำหนดเบื้องต้น: ต้องติดตั้ง Python 3.10+ และ Git

  • macOS: brew install python3 git
  • Ubuntu/Debian: sudo apt install python3 python3-venv git
  • Windows: python.org (เลือก "Add to PATH" ระหว่างการติดตั้ง) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

สคริปต์ติดตั้งจะสร้างสภาพแวดล้อมเสมือน ติดตั้งการพึ่งพา และพิมพ์การกำหนดค่าไคลเอนต์ MCP ให้คุณ

แก้ไข .env ด้วยข้อมูลรับรองของคุณ:

# 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

ขั้นตอนที่ 3: ทดสอบ Server ในเครื่อง

Mac/Linux:

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

Windows (PowerShell):

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

คุณควรเห็น:

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

กด Ctrl+C เพื่อหยุด

การแก้ไขปัญหา: ตรวจสอบบันทึก

หากคุณพบปัญหาเมื่อใช้ MCP server กับ Claude Desktop หรือไคลเอนต์อื่นๆ ให้ตรวจสอบไฟล์บันทึก:

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

การผสานรวม

หมายเหตุ: แทนที่ /path/to/capital-mcp/venv/bin/python ด้วยพาธ Python venv จริงของคุณ สคริปต์ติดตั้งจะพิมพ์ค่านี้ให้คุณ บน Windows ให้ใช้ C:\path\to\capital-mcp\venv\Scripts\python.exe

Claude Desktop

💡 เคล็ดลับ: หากคุณติดตั้งผ่าน MCPB bundle (ตัวเลือก A ด้านบน) ให้ข้ามส่วนนี้ — Claude Desktop จะเขียนการกำหนดค่าให้คุณตาม manifest.json ใช้ส่วนนี้สำหรับการติดตั้งสคริปต์ด้วยตนเองเท่านั้น

macOS/Linux

ตำแหน่งการกำหนดค่า: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) หรือ ~/.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": ""
      }
    }
  }
}

รีสตาร์ท Claude Desktop ตรวจสอบโดยพิมพ์: "มีเครื่องมือ Capital.com อะไรบ้างที่พร้อมใช้งาน?"

Windows

ตำแหน่งการกำหนดค่า: %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": ""
      }
    }
  }
}

รีสตาร์ท Claude Desktop

Claude Code

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

Cursor IDE

เปิดการตั้งค่า (Cmd+, / Ctrl+,) > ส่วนขยาย > MCP > กำหนดค่า เพิ่ม:

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

รีสตาร์ท Cursor

Codex

การตั้งค่า > MCP Servers > เพิ่มเซิร์ฟเวอร์ ใช้คำสั่ง อาร์กิวเมนต์ และตัวแปรสภาพแวดล้อมเดียวกันกับด้านบน

Windsurf

สร้าง/แก้ไข ~/.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"
      }
    }
  }
}

รีสตาร์ท Windsurf

ไคลเอนต์ MCP ที่กำหนดเอง

ไคลเอนต์ MCP ที่รองรับ STDIO ใดๆ ก็ใช้งานได้ ตัวอย่างด้วย 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

ตัวอย่างการใช้งาน

ตัวอย่างการสนทนากับ 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

ขั้นตอนการดำเนินการเทรด (เมื่อเปิดใช้งานการเทรด)

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"

ข้อมูลอ้างอิงตัวแปรสภาพแวดล้อม

จำเป็น

  • CAP_ENV - สภาพแวดล้อม: demo หรือ live (ค่าเริ่มต้น: demo)
  • CAP_API_KEY - คีย์ API จาก Capital.com
  • CAP_IDENTIFIER - อีเมลเข้าสู่ระบบ
  • CAP_API_PASSWORD - รหัสผ่านที่กำหนดเองของคีย์ API

การควบคุมความเสี่ยง (แนะนำ)

  • CAP_ALLOW_TRADING - เปิดใช้งานการเทรด (ค่าเริ่มต้น: false)
  • CAP_ALLOWED_EPICS - รายการที่อนุญาตคั่นด้วยเครื่องหมายจุลภาค (เช่น "SILVER,GOLD,BTCUSD") หรือ "ALL" สำหรับไม่จำกัด
  • CAP_MAX_POSITION_SIZE - ขนาดโพสิชันสูงสุด (ค่าเริ่มต้น: 1.0)
  • CAP_MAX_WORKING_ORDER_SIZE - ขนาดคำสั่งสูงสุด (ค่าเริ่มต้น: 1.0)
  • CAP_MAX_OPEN_POSITIONS - จำนวนโพสิชันพร้อมกันสูงสุด (ค่าเริ่มต้น: 3)
  • CAP_MAX_ORDERS_PER_DAY - ขีดจำกัดคำสั่งรายวัน (ค่าเริ่มต้น: 20)
  • CAP_REQUIRE_EXPLICIT_CONFIRM - ต้องการ confirm=true (ค่าเริ่มต้น: true)
  • CAP_DRY_RUN - บล็อกการดำเนินการเทรดทั้งหมด (ค่าเริ่มต้น: false)

ตัวเลือกเสริม

  • CAP_DEFAULT_ACCOUNT_ID - บัญชีเริ่มต้นหลังจากเข้าสู่ระบบ
  • CAP_HTTP_TIMEOUT_S - หมดเวลา HTTP (ค่าเริ่มต้น: 15)
  • CAP_LOG_LEVEL - ระดับบันทึก: DEBUG, INFO, WARNING, ERROR (ค่าเริ่มต้น: INFO)

เครื่องมือ MCP (36 รายการที่นำไปใช้แล้ว)

เซสชัน (4)

  • cap_session_status - รับข้อมูลเซสชัน
  • cap_session_login - สร้างเซสชัน
  • cap_session_ping - คงการเชื่อมต่อ
  • cap_session_logout - สิ้นสุดเซสชัน

ข้อมูลตลาด (6)

  • cap_market_search - ค้นหาตลาด
  • cap_market_get - รับรายละเอียดตลาด
  • cap_market_prices - ราคาย้อนหลัง
  • cap_market_sentiment - ความเชื่อมั่นของลูกค้า
  • cap_market_navigation_root - หมวดหมู่ตลาดหลัก
  • cap_market_navigation_node - โหนดหมวดหมู่ตลาด

บัญชี (6)

  • cap_account_list - แสดงรายการบัญชี
  • cap_account_preferences_get - รับการตั้งค่า
  • cap_account_preferences_set - ตั้งค่าการตั้งค่า
  • cap_account_history_activity - ประวัติกิจกรรม
  • cap_account_history_transactions - ประวัติธุรกรรม
  • cap_account_demo_topup - เติมเงินบัญชี demo

การเทรด (11)

  • อ่านอย่างเดียว:

    • cap_trade_positions_list - แสดงรายการโพสิชัน
    • cap_trade_positions_get - รับรายละเอียดโพสิชัน
    • cap_trade_orders_list - แสดงรายการคำสั่งที่ทำงานอยู่
    • cap_trade_confirm_get - รับสถานะการยืนยัน
    • cap_trade_confirm_wait - รอการยืนยัน
  • ดูตัวอย่าง:

    • cap_trade_preview_position - ดูตัวอย่างโพสิชัน
    • cap_trade_preview_working_order - ดูตัวอย่างคำสั่ง
  • ดำเนินการ:

    • cap_trade_execute_position - ดำเนินการโพสิชัน
    • cap_trade_execute_working_order - ดำเนินการคำสั่ง
    • cap_trade_positions_close - ปิดโพสิชัน
    • cap_trade_orders_cancel - ยกเลิกคำสั่ง

รายการเฝ้าดู (6)

  • cap_watchlists_list - แสดงรายการเฝ้าดู
  • cap_watchlists_create - สร้างรายการเฝ้าดู
  • cap_watchlists_get - รับรายการเฝ้าดู
  • cap_watchlists_add_market - เพิ่มตลาด
  • cap_watchlists_delete - ลบรายการเฝ้าดู
  • cap_watchlists_remove_market - ลบตลาด

การสตรีม (3)

  • cap_stream_prices - สตรีมราคาเรียลไทม์ (WebSocket)
  • cap_stream_alerts - สตรีมการแจ้งเตือนระดับราคา (WebSocket)
  • cap_stream_portfolio - สตรีมพอร์ตโฟลิโอ P&L สด (WebSocket)

MCP Prompts (เทมเพลตเวิร์กโฟลว์)

MCP prompts เป็นเวิร์กโฟลว์ที่มีโครงสร้างซึ่งแนะนำ Claude ผ่านการดำเนินการเทรดหลายขั้นตอนที่ซับซ้อน โดยให้คำแนะนำทีละขั้นตอนและแนวทางปฏิบัติที่ดีที่สุดสำหรับงานทั่วไป

Prompts ที่พร้อมใช้งาน (7)

1. market_scan - เวิร์กโฟลว์การวิเคราะห์ตลาด

แนะนำคุณในการสแกนรายการเฝ้าดูเพื่อหาเงื่อนไขการเทรด

พารามิเตอร์:

  • watchlist_id - รายการเฝ้าดูที่จะสแกน (เว้นว่างไว้เพื่อแสดงรายการเฝ้าดูก่อน)
  • timeframe - ความละเอียดราคา: MINUTE, MINUTE_5, HOUR, DAY (ค่าเริ่มต้น: HOUR)
  • lookback_periods - จำนวนแท่งเทียนที่จะดึง: 1-1000 (ค่าเริ่มต้น: 24)

เวิร์กโฟลว์:

  1. รับตลาดในรายการเฝ้าดู
  2. ดึงข้อมูลราคาสำหรับแต่ละตลาด
  3. การวิเคราะห์ทางเทคนิค (แนวโน้ม, แนวรับ/แนวต้าน, รูปแบบ)
  4. การตรวจสอบความเชื่อมั่น (ตัวเลือกเสริม)
  5. สร้างสรุปโอกาส

ตัวอย่างการใช้งาน:

  • "ใช้ market_scan prompt เพื่อวิเคราะห์รายการเฝ้าดูของฉัน"
  • "สแกนตลาดของฉันเพื่อหาโอกาสในการเทรด"

การเทรดจริง: เปลี่ยนการกำหนดค่าของคุณเป็น: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - เวิร์กโฟลว์การวางแผนการเทรด

แนะนำคุณในการสร้างข้อเสนอการเทรดด้วยเครื่องมือการจัดการความเสี่ยง

พารามิเตอร์:

  • epic - ตลาดที่จะเทรด (จำเป็น เช่น SILVER, GOLD)
  • direction - BUY หรือ SELL (ค่าเริ่มต้น: BUY)
  • thesis - เหตุผลในการเทรดของคุณ (ตัวเลือกเสริม)
  • risk_percent - ความเสี่ยงเป็น % ของยอดคงเหลือ (ค่าเริ่มต้น: 1.0%)

เวิร์กโฟลว์:

  1. ดึงรายละเอียดตลาดและกฎการซื้อขาย
  2. คำนวณขนาดโพสิชันตาม % ความเสี่ยง
  3. กำหนดระดับ stop loss และ take profit
  4. ดูตัวอย่างการเทรด (การตรวจสอบเท่านั้น - ไม่มีการดำเนินการ)
  5. ส่งคืน preview_id สำหรับการดำเนินการที่อาจเกิดขึ้น

ตัวอย่างการใช้งาน:

  • "สร้างข้อเสนอการเทรดสำหรับ SILVER"
  • "เสนอการเทรด long บน GOLD ด้วยความเสี่ยง 2%"

หมายเหตุ: prompt นี้ไม่ได้ดำเนินการเทรด - สร้างเพียงตัวอย่างเท่านั้น

3. execute_trade - เวิร์กโฟลว์การดำเนินการเทรด

แนะนำคุณในการดำเนินการเทรดที่ดูตัวอย่างไว้

พารามิเตอร์:

  • preview_id - Preview ID จาก trade_proposal (จำเป็น)

เวิร์กโฟลว์:

  1. ตรวจสอบว่าได้ระบุ preview_id และถูกต้อง
  2. ตรวจสอบการควบคุมความเสี่ยงทั้งหมดอีกครั้ง
  3. ดำเนินการโพสิชันกับโบรกเกอร์
  4. ตรวจสอบการยืนยัน (ACCEPTED/REJECTED)
  5. รายงานสถานะสุดท้าย

ตัวอย่างการใช้งาน:

  • "ดำเนินการเทรดที่ฉันเพิ่งดูตัวอย่าง"
  • "วางคำสั่งเทรดด้วย preview ID abc-123"

หมายเหตุ:

  • ต้องการ CAP_ALLOW_TRADING=true
  • ต้องการ epic ในรายการที่อนุญาต
  • ตัวอย่างต้องไม่หมดอายุ (TTL 2 นาที)
  • ⚠️ สิ่งนี้จะทำการเทรดจริง

4. position_review - เวิร์กโฟลว์การวิเคราะห์พอร์ตโฟลิโอ

แนะนำคุณในการวิเคราะห์โพสิชันและคำสั่งที่เปิดอยู่

พารามิเตอร์: ไม่มี (วิเคราะห์โพสิชันปัจจุบันทั้งหมด)

เวิร์กโฟลว์:

  1. ดึงโพสิชันที่เปิดอยู่ทั้งหมด
  2. ดึงคำสั่งที่ทำงานอยู่ทั้งหมด
  3. คำนวณเมตริก P&L, ความเสี่ยง และความเสี่ยง
  4. ระบุความเสี่ยงจากการกระจุกตัวและสหสัมพันธ์
  5. แนะนำการปรับเปลี่ยนที่เป็นไปได้ (โดยไม่ต้องดำเนินการ)

ตัวอย่างการใช้งาน:

  • "ตรวจสอบโพสิชันปัจจุบันของฉัน"
  • "วิเคราะห์ความเสี่ยงพอร์ตโฟลิโอของฉัน"

หมายเหตุ: นี่คือเวิร์กโฟลว์แบบอ่านอย่างเดียว - ไม่มีการดำเนินการเทรด

5. live_price_monitor - การติดตามราคาเรียลไทม์ (WebSocket)

ตรวจสอบราคาตลาดสดพร้อมการแจ้งเตือนทันทีเมื่อราคาเคลื่อนไหวเกินเกณฑ์

พารามิเตอร์:

  • epics - รายการ EPIC ของตลาดที่จะตรวจสอบ (เว้นว่างเพื่อค้นหา/เลือก สูงสุด 40)
  • duration_minutes - ระยะเวลาในการตรวจสอบ (ค่าเริ่มต้น: 5 นาที สูงสุด: 10 นาที)
  • threshold_percent - แจ้งเตือนเมื่อราคาเคลื่อนไหว > % นี้ (ค่าเริ่มต้น: 1.0%)

เวิร์กโฟลว์:

  1. เลือกตลาดที่จะตรวจสอบ (หรือระบุ EPIC โดยตรง)
  2. ดึงราคาเริ่มต้นเพื่อสร้างพื้นฐาน
  3. สมัครรับข้อมูลอัปเดตราคา WebSocket แบบเรียลไทม์
  4. แสดงกระดานราคาสดพร้อมการอัปเดตต่อเนื่อง
  5. แจ้งเตือนเมื่อตลาดใดๆ เคลื่อนไหว > threshold_percent
  6. หยุดอัตโนมัติหลังจาก duration_minutes

ตัวอย่างการใช้งาน:

  • "ตรวจสอบราคา GOLD และ SILVER เป็นเวลา 2 นาที"
  • "เฝ้าดู BTC ในอีก 5 นาทีข้างหน้า แจ้งเตือนเมื่อเคลื่อนไหว 2%" หมายเหตุ: ต้องใช้ CAP_WS_ENABLED=true เซสชัน WebSocket ของ Capital.com มีอายุสูงสุด 10 นาที

6. real_time_alerts - การแจ้งเตือนราคาแบบมีเงื่อนไข (WebSocket)

ตั้งค่าระดับราคาแจ้งเตือนและรับการแจ้งเตือนทันทีเมื่อตลาดถึงเป้าหมายของคุณ

พารามิเตอร์:

  • alert_config - ระดับการแจ้งเตือนต่อ EPIC (เช่น {"GOLD": 2050.0, "SILVER": 28.5})
  • duration_minutes - ระยะเวลาการติดตามสูงสุด (ค่าเริ่มต้น: 5 นาที)
  • auto_stop - หยุดการติดตามหลังจากการแจ้งเตือนครั้งแรก? (ค่าเริ่มต้น: true)

ขั้นตอนการทำงาน:

  1. กำหนดค่าเงื่อนไขการแจ้งเตือน (ระดับราคาสำหรับแต่ละตลาด)
  2. สมัครรับข้อมูลอัปเดตราคาผ่าน WebSocket
  3. ติดตามอย่างต่อเนื่องเพื่อหาทริกเกอร์การแจ้งเตือน
  4. ส่งการแจ้งเตือนทันทีเมื่อตรงตามเงื่อนไข
  5. เลือกที่จะติดตามต่อหรือหยุดหลังจากการแจ้งเตือนครั้งแรก

ตัวอย่างการใช้งาน:

  • "แจ้งเตือนฉันเมื่อ GOLD ถึง 2050"
  • "แจ้งเมื่อ SILVER ลดลงต่ำกว่า 28"

หมายเหตุ: ต้องใช้ CAP_WS_ENABLED=true

7. live_portfolio_monitor - การติดตาม P&L แบบเรียลไทม์ (WebSocket)

ดู P&L ของพอร์ตโฟลิโอของคุณอัปเดตแบบเรียลไทม์เมื่อราคาตลาดเคลื่อนไหว

พารามิเตอร์:

  • duration_minutes - ระยะเวลาการติดตาม (ค่าเริ่มต้น: 5 นาที, สูงสุด: 10 นาที)
  • alert_pnl_threshold - แจ้งเตือนเมื่อ P&L รวมเกินจำนวนนี้ (ค่าเริ่มต้น: $100)

ขั้นตอนการทำงาน:

  1. ดึงข้อมูลตำแหน่งที่เปิดอยู่ในปัจจุบัน
  2. สมัครรับข้อมูลอัปเดตราคาสำหรับตลาดของตำแหน่งนั้นๆ
  3. คำนวณ P&L สดเมื่อราคาเปลี่ยนแปลง
  4. แสดงแดชบอร์ดพอร์ตโฟลิโอแบบเรียลไทม์
  5. แจ้งเตือนเมื่อ P&L เกินเกณฑ์ที่กำหนด

ตัวอย่างการใช้งาน:

  • "ติดตาม P&L พอร์ตโฟลิโอของฉันเป็นเวลา 5 นาที"
  • "ดูตำแหน่งแบบเรียลไทม์ แจ้งเตือนที่ P&L $500"

หมายเหตุ: ต้องใช้ CAP_WS_ENABLED=true และมีตำแหน่งที่เปิดอยู่

วิธีใช้พรอมต์

ใน Claude Desktop หรือไคลเอนต์ MCP อื่นๆ พรอมต์จะปรากฏเป็นรูปแบบการโต้ตอบที่พร้อมใช้งาน คุณสามารถเรียกใช้ได้อย่างเป็นธรรมชาติในการสนทนา:

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]

พรอมต์ให้คำแนะนำที่มีโครงสร้างในขณะที่ยังคงการควบคุมการเทรดตลอดขั้นตอนการทำงาน

ทรัพยากร MCP (ข้อมูลแบบอ่านอย่างเดียว)

ทรัพยากร MCP ให้การเข้าถึงสถานะเซิร์ฟเวอร์และการกำหนดค่าแบบอ่านอย่างเดียวผ่านทรัพยากรที่ใช้ URI ซึ่งแตกต่างจากเครื่องมือ (ที่ดำเนินการ) ทรัพยากรจะเปิดเผยข้อมูลที่ไคลเอนต์สามารถอ่านและติดตามได้

ทรัพยากรที่พร้อมใช้งาน

1. cap://status - สถานะเซิร์ฟเวอร์

ข้อมูลเซิร์ฟเวอร์และเซสชันแบบเรียลไทม์

ส่งคืน: JSON พร้อมความสมบูรณ์ของเซิร์ฟเวอร์, สถานะเซสชัน, สถานะการตรวจสอบสิทธิ์, ขีดจำกัดอัตรา

ตัวอย่าง:

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

กรณีการใช้งาน: ตรวจสอบความสมบูรณ์ของเซิร์ฟเวอร์, ตรวจสอบสถานะเซสชัน, แก้ไขปัญหาการตรวจสอบสิทธิ์


2. cap://risk-policy - นโยบายความเสี่ยง

การกำหนดค่าการจัดการความเสี่ยงและการควบคุมการเทรดที่ครอบคลุม

ส่งคืน: JSON พร้อมเลเยอร์การตรวจสอบความถูกต้องทั้งหมด, คุณสมบัติการควบคุมการเทรด และข้อจำกัดการเทรด

ตัวอย่าง:

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

กรณีการใช้งาน: ทำความเข้าใจการควบคุมการเทรดที่ใช้งานอยู่, ตรวจสอบการกำหนดค่าความเสี่ยง, เอกสารการปฏิบัติตามกฎระเบียบ


3. cap://allowed-epics - รายการอนุญาตการเทรด

การกำหนดค่ารายการอนุญาตการเทรดปัจจุบันที่แสดงตลาดที่ได้รับอนุญาต

ส่งคืน: JSON พร้อมโหมดรายการอนุญาต, EPIC ที่ได้รับอนุญาต และคำแนะนำการกำหนดค่า

ตัวอย่าง:

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

กรณีการใช้งาน: ตรวจสอบว่าตลาดใดที่สามารถเทรดได้, ตรวจสอบการกำหนดค่ารายการอนุญาต


4. cap://market-cache/{epic} - รายละเอียดตลาด (ไดนามิก)

รายละเอียดตลาดที่แคชไว้สำหรับ EPIC เฉพาะ (ดึงข้อมูลสดจากโบรกเกอร์)

พารามิเตอร์:

  • epic - ตัวระบุตลาด (เช่น "GOLD", "SILVER", "CS.D.EURUSD.TODAY.IP")

ส่งคืน: JSON พร้อมข้อมูลตลาดที่ครอบคลุม

การตรวจสอบสิทธิ์: จำเป็น

ตัวอย่าง: 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"
}

กรณีการใช้งาน: รับรายละเอียดตลาด, ตรวจสอบกฎการเทรด, วิเคราะห์ข้อกำหนดมาร์จิ้น


วิธีใช้ทรัพยากร

ใน Claude Desktop หรือไคลเอนต์ MCP อื่นๆ สามารถเข้าถึงทรัพยากรได้โดย 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]

ทรัพยากรเป็นวิธีที่สะดวกในการตรวจสอบสถานะเซิร์ฟเวอร์และการกำหนดค่าโดยไม่ต้องเรียกใช้เครื่องมือ สำหรับข้อมูลรายการเฝ้าดู ให้ใช้เครื่องมือ cap_watchlists_list และ cap_watchlists_get

กระบวนการดำเนินการเทรด

การดำเนินการสองขั้นตอนที่บังคับ

การดำเนินการที่มีผลข้างเคียงทั้งหมดใช้ขั้นตอนการแสดงตัวอย่าง → ดำเนินการที่เข้มงวด:

  1. แสดงตัวอย่าง: ตรวจสอบความถูกต้องของเทรดกับกฎของโบรกเกอร์ + นโยบายความเสี่ยงในเครื่อง

    • ส่งคืน preview_id พร้อมคำขอที่ทำให้เป็นมาตรฐาน + การตรวจสอบความเสี่ยง
    • ไม่มีผลข้างเคียง, การตรวจสอบความถูกต้องแบบอ่านอย่างเดียว
  2. ดำเนินการ: ส่งเทรดโดยใช้ preview_id

    • เรียกใช้การตรวจสอบที่สำคัญอีกครั้ง
    • ต้องใช้ confirm=true หาก CAP_REQUIRE_EXPLICIT_CONFIRM=true
    • โพลการยืนยันจากโบรกเกอร์
    • เพิ่มตัวนับคำสั่งรายวัน

การควบคุมความเสี่ยง

  • รายการอนุญาต: เฉพาะ EPIC ใน CAP_ALLOWED_EPICS เท่านั้นที่สามารถเทรดได้
  • ขีดจำกัดขนาด: บังคับใช้ขนาดตำแหน่ง/คำสั่งสูงสุด
  • ขีดจำกัดตำแหน่ง: ตำแหน่งที่เปิดสูงสุด ณ เวลาใดๆ
  • ขีดจำกัดรายวัน: คำสั่งสูงสุดต่อวัน
  • การทำให้ขนาดเป็นมาตรฐาน: ปัดเศษเป็นค่าต่ำสุด/สูงสุด/เพิ่มทีละของโบรกเกอร์
  • โหมด Dry-Run: บล็อกการดำเนินการทั้งหมดเมื่อเปิดใช้งาน

เอกสารประกอบ

ใบอนุญาต

MIT

ข้อจำกัดความรับผิดชอบ – การใช้ Capital.com Public API กับเครื่องมือของบุคคลที่สาม

การรวมเข้ากับบุคคลที่สาม

หน้านี้อธิบายวิธีที่ลูกค้าสามารถเชื่อมต่อ Capital.com Public API กับซอฟต์แวร์ เครื่องมือ หรือการรวมระบบของบุคคลที่สาม รวมถึงที่ขับเคลื่อนโดยปัญญาประดิษฐ์หรือโมเดลภาษาขนาดใหญ่ ('LLMs') ซอฟต์แวร์ เครื่องมือ หรือการรวมระบบของบุคคลที่สามดังกล่าวเป็นอิสระจาก Capital.com และไม่ได้เป็นส่วนหนึ่งของบริการของ Capital.com Capital.com ไม่ได้ควบคุม พัฒนา รับรอง หรือยอมรับความรับผิดใดๆ สำหรับซอฟต์แวร์ของบุคคลที่สาม ฟังก์ชันการทำงาน ผลลัพธ์ หรือผลลัพธ์ใดๆ ที่เกิดจากการใช้งาน การใช้เครื่องมือหรือการรวมระบบของบุคคลที่สามร่วมกับ Capital.com Public API ถือเป็นความเสี่ยงของคุณเอง คุณมีหน้าที่ตรวจสอบข้อกำหนด นโยบายความเป็นส่วนตัว และแนวทางปฏิบัติในการจัดการข้อมูลของเครื่องมือของบุคคลที่สามใดๆ ที่คุณเลือกใช้

การใช้ Public API

การใช้ Capital.com Public API ของคุณถือเป็นดุลยพินิจและความเสี่ยงของคุณเองทั้งหมด Capital.com ให้บริการ Public API เพื่อวัตถุประสงค์ในการให้ข้อมูลและการเทรด แต่ไม่ได้แนะนำ รับรอง หรือสนับสนุนการใช้งาน การรวมระบบ หรือกลยุทธ์การเทรดใดๆ โดยเฉพาะ คุณเป็นผู้รับผิดชอบแต่เพียงผู้เดียวสำหรับวิธีที่คุณเข้าถึงและใช้ API รวมถึงพารามิเตอร์ของคำสั่งใดๆ ที่ส่ง การกำหนดค่าเครื่องมือหรือระบบที่เชื่อมต่อ และการตีความข้อมูลใดๆ ที่ได้รับ Capital.com ไม่ยอมรับความรับผิดต่อการสูญเสียหรือผลลัพธ์ที่ไม่ได้ตั้งใจซึ่งเกิดจากการใช้ API ของคุณ ไม่ว่าจะเข้าถึงโดยตรงหรือผ่านเครื่องมือของบุคคลที่สาม ความพร้อมใช้งาน ฟังก์ชันการทำงาน และข้อกำหนดของ API อาจถูกแก้ไข จำกัดอัตรา ระงับ หรือยกเลิกเมื่อใดก็ได้โดยไม่ต้องแจ้งให้ทราบล่วงหน้า การใช้ Public API ของคุณอยู่ภายใต้ข้อกำหนดและเงื่อนไขและข้อกำหนดการเทรดทางอิเล็กทรอนิกส์ของ Capital.com ซึ่งคุณควรอ่านอย่างละเอียดก่อนใช้ API

บริการดำเนินการเท่านั้นและไม่มีคำแนะนำการลงทุน Capital.com ให้บริการบนพื้นฐานการดำเนินการเท่านั้น การเทรดตราสารทางการเงินมีความเสี่ยงอย่างมากที่จะขาดทุน ไม่มีสิ่งใดในหน้านี้ ใน Public API หรือในซอฟต์แวร์หรือการรวมระบบของบุคคลที่สามใดๆ ที่ถือเป็นคำแนะนำการลงทุน คำแนะนำส่วนบุคคล หรือการชักชวนให้ซื้อหรือขายตราสารทางการเงินใดๆ ซึ่งรวมถึงผลลัพธ์ สัญญาณ ข้อเสนอแนะ หรือการวิเคราะห์ใดๆ ที่สร้างโดย AI เครื่องมือที่ใช้ LLM หรือเครื่องมืออัตโนมัติอื่นๆ การตัดสินใจเทรดทั้งหมด รวมถึงกิจกรรมอัตโนมัติหรืออัลกอริทึมใดๆ กระทำด้วยความเสี่ยงของคุณเองและยังคงเป็นความรับผิดชอบของคุณแต่เพียงผู้เดียว ความเสี่ยงของการเทรดอัตโนมัติและอัลกอริทึม การใช้ Public API ร่วมกับเครื่องมือเทรดอัตโนมัติหรืออัลกอริทึมมีความเสี่ยงเพิ่มเติม ซึ่งรวมถึงแต่ไม่จำกัดเพียง: การดำเนินการคำสั่งอย่างรวดเร็วโดยไม่มีการตรวจสอบหรือแทรกแซงจากมนุษย์; ข้อผิดพลาดของระบบ ความล้มเหลวของซอฟต์แวร์ หรือปัญหาการเชื่อมต่อ; การดำเนินการในราคาที่แตกต่างอย่างมากจากที่คาดไว้; และคำสั่งที่ไม่ได้ตั้งใจหรือผิดพลาดอันเป็นผลมาจากเครื่องมือหรือพารามิเตอร์ที่กำหนดค่าไม่ถูกต้อง Capital.com จะไม่รับผิดชอบต่อการสูญเสียใดๆ ที่เกิดจากความเสี่ยงดังกล่าวหรือจากการโต้ตอบระหว่างระบบของ Capital.com กับเครื่องมือของบุคคลที่สามใดๆ ผลการดำเนินงานในอดีตและผลลัพธ์ใดๆ ที่สร้างโดยเครื่องมืออัตโนมัติไม่ได้บ่งชี้ถึงผลลัพธ์ในอนาคต

การใช้งานต้องห้าม

การใช้ Public API และเครื่องมือที่เชื่อมต่อใดๆ จะต้องไม่ถูกใช้เพื่อจัดการแพลตฟอร์ม Capital.com ใช้ประโยชน์จากราคาหรือความหน่วง มีส่วนร่วมในการละเมิดตลาด หรือได้รับความได้เปรียบที่ไม่เป็นธรรมใดๆ Capital.com ขอสงวนสิทธิ์ในการจำกัด ระงับ หรือยกเลิกการเข้าถึง API และ/หรือบัญชีของคุณ ในกรณีที่พิจารณาอย่างสมเหตุสมผลว่ามีการใช้งานในทางที่ผิดดังกล่าวเกิดขึ้นหรือมีแนวโน้มที่จะเกิดขึ้น ลูกค้าจะต้องไม่อนุญาตให้บุคคลที่สามใดๆ ใช้ดุลยพินิจในการควบคุมบัญชีของตน

ความรับผิดชอบของคุณ

คุณมีหน้าที่รับผิดชอบในการตรวจสอบให้แน่ใจว่าการใช้แพลตฟอร์ม Capital.com, Public API และเครื่องมือหรือการรวมระบบของบุคคลที่สามใดๆ ของคุณเป็นไปตามข้อกำหนดและเงื่อนไข ข้อกำหนดการเทรดทางอิเล็กทรอนิกส์ของ Capital.com และกฎหมายและข้อบังคับที่เกี่ยวข้องทั้งหมดในเขตอำนาจศาลของคุณ คุณควรพิจารณาอย่างรอบคอบว่าเครื่องมือเทรดอัตโนมัติเหมาะสมกับสถานการณ์ ประสบการณ์ และความเสี่ยงที่ยอมรับได้ของคุณหรือไม่ก่อนใช้งาน Capital.com ขอแนะนำอย่างยิ่งให้คุณทดสอบเครื่องมืออัตโนมัติหรือการรวมระบบใดๆ อย่างละเอียดโดยใช้บัญชีทดลองก่อนเชื่อมต่อกับสภาพแวดล้อมการเทรดจริง