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
-
สร้างบัญชี: ไปที่ capital.com/trading/signup
- เลือกบัญชี Demo สำหรับการทดสอบ (แนะนำ)
- ยืนยันอีเมลของคุณ
-
เปิดใช้งาน 2FA: การตั้งค่า > ความปลอดภัย > การยืนยันตัวตนสองขั้นตอน
- จำเป็นก่อนสร้างคีย์ API
-
สร้างคีย์ 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)
ขั้นตอน:
- โคลน repo และสร้าง
.mcpbbundle (ต้องใช้ 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 - เปิด
capital-mcp.mcpbใน Claude Desktop (ดับเบิลคลิก หรือลากลงในแอป) - Claude Desktop จะถามค่ากำหนดค่าผู้ใช้ (คีย์ API, ตัวระบุ, รหัสผ่าน, การควบคุมการเทรด) กรอกข้อมูลและคลิก Install
- รีสตาร์ท 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.comCAP_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)
เวิร์กโฟลว์:
- รับตลาดในรายการเฝ้าดู
- ดึงข้อมูลราคาสำหรับแต่ละตลาด
- การวิเคราะห์ทางเทคนิค (แนวโน้ม, แนวรับ/แนวต้าน, รูปแบบ)
- การตรวจสอบความเชื่อมั่น (ตัวเลือกเสริม)
- สร้างสรุปโอกาส
ตัวอย่างการใช้งาน:
- "ใช้ 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%)
เวิร์กโฟลว์:
- ดึงรายละเอียดตลาดและกฎการซื้อขาย
- คำนวณขนาดโพสิชันตาม % ความเสี่ยง
- กำหนดระดับ stop loss และ take profit
- ดูตัวอย่างการเทรด (การตรวจสอบเท่านั้น - ไม่มีการดำเนินการ)
- ส่งคืน preview_id สำหรับการดำเนินการที่อาจเกิดขึ้น
ตัวอย่างการใช้งาน:
- "สร้างข้อเสนอการเทรดสำหรับ SILVER"
- "เสนอการเทรด long บน GOLD ด้วยความเสี่ยง 2%"
หมายเหตุ: prompt นี้ไม่ได้ดำเนินการเทรด - สร้างเพียงตัวอย่างเท่านั้น
3. execute_trade - เวิร์กโฟลว์การดำเนินการเทรด
แนะนำคุณในการดำเนินการเทรดที่ดูตัวอย่างไว้
พารามิเตอร์:
preview_id- Preview ID จาก trade_proposal (จำเป็น)
เวิร์กโฟลว์:
- ตรวจสอบว่าได้ระบุ preview_id และถูกต้อง
- ตรวจสอบการควบคุมความเสี่ยงทั้งหมดอีกครั้ง
- ดำเนินการโพสิชันกับโบรกเกอร์
- ตรวจสอบการยืนยัน (ACCEPTED/REJECTED)
- รายงานสถานะสุดท้าย
ตัวอย่างการใช้งาน:
- "ดำเนินการเทรดที่ฉันเพิ่งดูตัวอย่าง"
- "วางคำสั่งเทรดด้วย preview ID abc-123"
หมายเหตุ:
- ต้องการ CAP_ALLOW_TRADING=true
- ต้องการ epic ในรายการที่อนุญาต
- ตัวอย่างต้องไม่หมดอายุ (TTL 2 นาที)
- ⚠️ สิ่งนี้จะทำการเทรดจริง
4. position_review - เวิร์กโฟลว์การวิเคราะห์พอร์ตโฟลิโอ
แนะนำคุณในการวิเคราะห์โพสิชันและคำสั่งที่เปิดอยู่
พารามิเตอร์: ไม่มี (วิเคราะห์โพสิชันปัจจุบันทั้งหมด)
เวิร์กโฟลว์:
- ดึงโพสิชันที่เปิดอยู่ทั้งหมด
- ดึงคำสั่งที่ทำงานอยู่ทั้งหมด
- คำนวณเมตริก P&L, ความเสี่ยง และความเสี่ยง
- ระบุความเสี่ยงจากการกระจุกตัวและสหสัมพันธ์
- แนะนำการปรับเปลี่ยนที่เป็นไปได้ (โดยไม่ต้องดำเนินการ)
ตัวอย่างการใช้งาน:
- "ตรวจสอบโพสิชันปัจจุบันของฉัน"
- "วิเคราะห์ความเสี่ยงพอร์ตโฟลิโอของฉัน"
หมายเหตุ: นี่คือเวิร์กโฟลว์แบบอ่านอย่างเดียว - ไม่มีการดำเนินการเทรด
5. live_price_monitor - การติดตามราคาเรียลไทม์ (WebSocket)
ตรวจสอบราคาตลาดสดพร้อมการแจ้งเตือนทันทีเมื่อราคาเคลื่อนไหวเกินเกณฑ์
พารามิเตอร์:
epics- รายการ EPIC ของตลาดที่จะตรวจสอบ (เว้นว่างเพื่อค้นหา/เลือก สูงสุด 40)duration_minutes- ระยะเวลาในการตรวจสอบ (ค่าเริ่มต้น: 5 นาที สูงสุด: 10 นาที)threshold_percent- แจ้งเตือนเมื่อราคาเคลื่อนไหว > % นี้ (ค่าเริ่มต้น: 1.0%)
เวิร์กโฟลว์:
- เลือกตลาดที่จะตรวจสอบ (หรือระบุ EPIC โดยตรง)
- ดึงราคาเริ่มต้นเพื่อสร้างพื้นฐาน
- สมัครรับข้อมูลอัปเดตราคา WebSocket แบบเรียลไทม์
- แสดงกระดานราคาสดพร้อมการอัปเดตต่อเนื่อง
- แจ้งเตือนเมื่อตลาดใดๆ เคลื่อนไหว > threshold_percent
- หยุดอัตโนมัติหลังจาก 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)
ขั้นตอนการทำงาน:
- กำหนดค่าเงื่อนไขการแจ้งเตือน (ระดับราคาสำหรับแต่ละตลาด)
- สมัครรับข้อมูลอัปเดตราคาผ่าน WebSocket
- ติดตามอย่างต่อเนื่องเพื่อหาทริกเกอร์การแจ้งเตือน
- ส่งการแจ้งเตือนทันทีเมื่อตรงตามเงื่อนไข
- เลือกที่จะติดตามต่อหรือหยุดหลังจากการแจ้งเตือนครั้งแรก
ตัวอย่างการใช้งาน:
- "แจ้งเตือนฉันเมื่อ 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)
ขั้นตอนการทำงาน:
- ดึงข้อมูลตำแหน่งที่เปิดอยู่ในปัจจุบัน
- สมัครรับข้อมูลอัปเดตราคาสำหรับตลาดของตำแหน่งนั้นๆ
- คำนวณ P&L สดเมื่อราคาเปลี่ยนแปลง
- แสดงแดชบอร์ดพอร์ตโฟลิโอแบบเรียลไทม์
- แจ้งเตือนเมื่อ 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
กระบวนการดำเนินการเทรด
การดำเนินการสองขั้นตอนที่บังคับ
การดำเนินการที่มีผลข้างเคียงทั้งหมดใช้ขั้นตอนการแสดงตัวอย่าง → ดำเนินการที่เข้มงวด:
-
แสดงตัวอย่าง: ตรวจสอบความถูกต้องของเทรดกับกฎของโบรกเกอร์ + นโยบายความเสี่ยงในเครื่อง
- ส่งคืน
preview_idพร้อมคำขอที่ทำให้เป็นมาตรฐาน + การตรวจสอบความเสี่ยง - ไม่มีผลข้างเคียง, การตรวจสอบความถูกต้องแบบอ่านอย่างเดียว
- ส่งคืน
-
ดำเนินการ: ส่งเทรดโดยใช้
preview_id- เรียกใช้การตรวจสอบที่สำคัญอีกครั้ง
- ต้องใช้
confirm=trueหากCAP_REQUIRE_EXPLICIT_CONFIRM=true - โพลการยืนยันจากโบรกเกอร์
- เพิ่มตัวนับคำสั่งรายวัน
การควบคุมความเสี่ยง
- รายการอนุญาต: เฉพาะ EPIC ใน
CAP_ALLOWED_EPICSเท่านั้นที่สามารถเทรดได้ - ขีดจำกัดขนาด: บังคับใช้ขนาดตำแหน่ง/คำสั่งสูงสุด
- ขีดจำกัดตำแหน่ง: ตำแหน่งที่เปิดสูงสุด ณ เวลาใดๆ
- ขีดจำกัดรายวัน: คำสั่งสูงสุดต่อวัน
- การทำให้ขนาดเป็นมาตรฐาน: ปัดเศษเป็นค่าต่ำสุด/สูงสุด/เพิ่มทีละของโบรกเกอร์
- โหมด Dry-Run: บล็อกการดำเนินการทั้งหมดเมื่อเปิดใช้งาน
เอกสารประกอบ
- คู่มือการใช้งาน: USAGE.md - คู่มือการใช้งานที่ครอบคลุมพร้อมตัวอย่าง
- เอกสารอ้างอิง Capital.com API: https://open-api.capital.com/
- Capital.com API Postman Collection: https://github.com/capital-com-sv/capital-api-postman
ใบอนุญาต
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 ขอแนะนำอย่างยิ่งให้คุณทดสอบเครื่องมืออัตโนมัติหรือการรวมระบบใดๆ อย่างละเอียดโดยใช้บัญชีทดลองก่อนเชื่อมต่อกับสภาพแวดล้อมการเทรดจริง