Capital.com Public API MCP Server

Capital.com MCP Server

Server Model Context Protocol (MCP) untuk Capital.com Open API - memungkinkan akses berbasis LLM ke akun trading Capital.com Anda.

⚠️ Pemberitahuan Penting

Penggunaan Anda terhadap Capital.com Public API dan alat pihak ketiga apa pun yang Anda hubungkan, termasuk alat berbasis AI atau LLM, sepenuhnya merupakan kebijaksanaan dan risiko Anda sendiri. Capital.com beroperasi hanya berdasarkan eksekusi dan tidak mengendalikan, mendukung, atau bertanggung jawab atas perangkat lunak pihak ketiga mana pun, keluarannya, atau hasil apa pun yang ditimbulkan. Tidak ada di halaman ini yang merupakan saran investasi atau rekomendasi untuk berdagang. Anda sepenuhnya bertanggung jawab atas semua keputusan trading, konfigurasi, dan aktivitas otomatis di akun Anda, dan harus memastikan penggunaan Anda mematuhi Syarat dan Ketentuan Capital.com, Ketentuan Trading Elektronik, dan semua hukum yang berlaku di yurisdiksi Anda.

Crypto Derivatives tidak tersedia untuk klien Ritel yang terdaftar di Capital Com (UK) Ltd.

• Selalu mulai dengan akun Demo sebelum mempertimbangkan trading langsung
• Trading dinonaktifkan secara default dan memerlukan konfigurasi eksplisit
• Semua operasi trading memerlukan eksekusi dua fase (pratinjau → konfirmasi → eksekusi)
• Kontrol risiko bawaan: daftar izin, batas ukuran, batas pesanan harian
• Gunakan dengan risiko Anda sendiri - penulis tidak bertanggung jawab atas kerugian trading

Untuk pertanyaan/klarifikasi lebih lanjut, silakan merujuk ke FAQ: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Panduan Memulai Cepat

Langkah 1: Dapatkan Kredensial API Capital.com

1. Buat Akun: Buka capital.com/trading/signup

   • Pilih akun Demo untuk pengujian (disarankan)
   • Verifikasi email Anda

2. Aktifkan 2FA: Pengaturan > Keamanan > Otentikasi Dua Faktor

   • Diperlukan sebelum membuat kunci API

3. Buat Kunci API: Pengaturan > Integrasi API > Buat kunci baru

   • Tetapkan label (mis., "MCP Server")
   • Tetapkan kata sandi khusus (ini BUKAN kata sandi platform Anda)
   • Simpan kunci API yang ditampilkan (hanya ditampilkan sekali!)
   • Catatan: Kunci API mampu melakukan trading; Capital.com tidak menawarkan kunci hanya-baca

Langkah 2: Instal & Konfigurasi

Anda memiliki dua opsi instalasi:

Opsi A: Instal Sekali Klik melalui Bundel MCPB (Disarankan)

Repositori ini menyertakan manifest.json yang sesuai dengan spesifikasi MCPB (MCP Bundle) — standar terbuka dari Anthropic untuk mengemas server MCP lokal. Ini memungkinkan Anda menginstal server di Claude Desktop (dan klien lain yang kompatibel dengan MCPB) tanpa mengedit file konfigurasi secara manual.

Prasyarat: uv (server menggunakan uv sebagai runtime-nya — instal dengan brew install uv atau lihat dokumentasi uv).

Langkah-langkah:

1. Kloning repositori dan bangun bundel .mcpb (memerlukan Node.js untuk npx):

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

2. Buka capital-mcp.mcpb di Claude Desktop (klik dua kali, atau seret ke dalam aplikasi).
3. Claude Desktop akan meminta Anda untuk nilai konfigurasi pengguna (kunci API, pengenal, kata sandi, kontrol trading). Isi dan klik Instal.
4. Mulai ulang Claude Desktop dan verifikasi dengan bertanya: "Alat Capital.com apa yang tersedia?"

Lihat referensi CLI MCPB untuk perintah tambahan (validate, info, unpack, sign).

Opsi B: Instal Manual melalui Skrip

Prasyarat: Python 3.10+ dan Git harus diinstal.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (centang "Add to PATH" selama instalasi) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

Skrip instal akan membuat lingkungan virtual, menginstal dependensi, dan mencetak konfigurasi klien MCP untuk Anda.

Edit .env dengan kredensial Anda:

# 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

Langkah 3: Uji Server Secara Lokal

Mac/Linux:

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

Windows (PowerShell):

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

Anda seharusnya melihat:

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

Tekan Ctrl+C untuk berhenti.

Pemecahan Masalah: Periksa Log

Jika Anda mengalami masalah saat menggunakan server MCP dengan Claude Desktop atau klien lain, periksa file log:

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

---

Integrasi

Catatan: Ganti /path/to/capital-mcp/venv/bin/python dengan jalur Python venv Anda yang sebenarnya. Skrip instal mencetak ini untuk Anda. Di Windows, gunakan C:\path\to\capital-mcp\venv\Scripts\python.exe.

Claude Desktop

💡 Tip: Jika Anda menginstal melalui bundel MCPB (Opsi A di atas), lewati bagian ini — Claude Desktop menulis konfigurasi untuk Anda berdasarkan manifest.json. Gunakan bagian ini hanya untuk instalasi skrip manual.

macOS/Linux

Lokasi konfigurasi: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) atau ~/.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": ""
      }
    }
  }
}

Mulai ulang Claude Desktop. Verifikasi dengan mengetik: "Alat Capital.com apa yang tersedia?"

Windows

Lokasi konfigurasi: %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": ""
      }
    }
  }
}

Mulai ulang Claude Desktop.

Claude Code

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

Cursor IDE

Buka Pengaturan (Cmd+, / Ctrl+,) > Ekstensi > MCP > Konfigurasikan. Tambahkan:

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

Mulai ulang Cursor.

Codex

Pengaturan > Server MCP > Tambah server. Gunakan perintah, argumen, dan variabel env yang sama seperti di atas.

Windsurf

Buat/edit ~/.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"
      }
    }
  }
}

Mulai ulang Windsurf.

Klien MCP Kustom

Klien MCP apa pun yang mampu STDIO dapat digunakan. Contoh dengan 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

Contoh Penggunaan

Contoh Percakapan dengan 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

Alur Kerja Eksekusi Trading (Saat Trading Diaktifkan)

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"

Referensi Variabel Lingkungan

Diperlukan

• CAP_ENV - Lingkungan: demo atau live (default: demo)
• CAP_API_KEY - Kunci API dari Capital.com
• CAP_IDENTIFIER - Email login
• CAP_API_PASSWORD - Kata sandi khusus kunci API

Kontrol Risiko (Disarankan)

• CAP_ALLOW_TRADING - Aktifkan trading (default: false)
• CAP_ALLOWED_EPICS - Daftar izin yang dipisahkan koma (mis., "SILVER,GOLD,BTCUSD") atau "ALL" untuk tidak terbatas
• CAP_MAX_POSITION_SIZE - Ukuran posisi maks (default: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Ukuran pesanan maks (default: 1.0)
• CAP_MAX_OPEN_POSITIONS - Posisi bersamaan maks (default: 3)
• CAP_MAX_ORDERS_PER_DAY - Batas pesanan harian (default: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Memerlukan confirm=true (default: true)
• CAP_DRY_RUN - Blokir semua eksekusi trading (default: false)

Opsional

• CAP_DEFAULT_ACCOUNT_ID - Akun default setelah login
• CAP_HTTP_TIMEOUT_S - Timeout HTTP (default: 15)
• CAP_LOG_LEVEL - Level log: DEBUG, INFO, WARNING, ERROR (default: INFO)

Alat MCP (36 diimplementasikan)

Sesi (4)

• cap_session_status - Dapatkan info sesi
• cap_session_login - Buat sesi
• cap_session_ping - Tetap aktif
• cap_session_logout - Akhiri sesi

Data Pasar (6)

• cap_market_search - Cari pasar
• cap_market_get - Dapatkan detail pasar
• cap_market_prices - Harga historis
• cap_market_sentiment - Sentimen klien
• cap_market_navigation_root - Kategori pasar root
• cap_market_navigation_node - Node kategori pasar

Akun (6)

• cap_account_list - Daftar akun
• cap_account_preferences_get - Dapatkan preferensi
• cap_account_preferences_set - Atur preferensi
• cap_account_history_activity - Riwayat aktivitas
• cap_account_history_transactions - Riwayat transaksi
• cap_account_demo_topup - Isi ulang akun demo

Trading (11)

• Hanya-baca:

  • cap_trade_positions_list - Daftar posisi
  • cap_trade_positions_get - Dapatkan detail posisi
  • cap_trade_orders_list - Daftar pesanan kerja
  • cap_trade_confirm_get - Dapatkan status konfirmasi
  • cap_trade_confirm_wait - Tunggu konfirmasi

• Pratinjau:

  • cap_trade_preview_position - Pratinjau posisi
  • cap_trade_preview_working_order - Pratinjau pesanan

• Eksekusi:

  • cap_trade_execute_position - Eksekusi posisi
  • cap_trade_execute_working_order - Eksekusi pesanan
  • cap_trade_positions_close - Tutup posisi
  • cap_trade_orders_cancel - Batalkan pesanan

Daftar Pantau (6)

• cap_watchlists_list - Daftar daftar pantau
• cap_watchlists_create - Buat daftar pantau
• cap_watchlists_get - Dapatkan daftar pantau
• cap_watchlists_add_market - Tambah pasar
• cap_watchlists_delete - Hapus daftar pantau
• cap_watchlists_remove_market - Hapus pasar

Streaming (3)

• cap_stream_prices - Streaming harga real-time (WebSocket)
• cap_stream_alerts - Streaming peringatan level harga (WebSocket)
• cap_stream_portfolio - Streaming P&L portofolio langsung (WebSocket)

Prompt MCP (Template Alur Kerja)

Prompt MCP adalah alur kerja terstruktur yang memandu Claude melalui operasi trading multi-langkah yang kompleks. Mereka menyediakan instruksi langkah demi langkah dan praktik terbaik untuk tugas-tugas umum.

Prompt yang Tersedia (7)

1. market_scan - Alur Kerja Analisis Pasar

Memandu Anda melalui pemindaian daftar pantau untuk kondisi trading.

Parameter:

• watchlist_id - Daftar pantau untuk dipindai (biarkan kosong untuk mendaftar daftar pantau terlebih dahulu)
• timeframe - Resolusi harga: MINUTE, MINUTE_5, HOUR, DAY (default: HOUR)
• lookback_periods - Jumlah candle yang diambil: 1-1000 (default: 24)

Alur Kerja:

1. Dapatkan pasar daftar pantau
2. Ambil data harga untuk setiap pasar
3. Analisis teknis (tren, support/resistance, pola)
4. Pemeriksaan sentimen opsional
5. Hasilkan ringkasan peluang

Contoh Penggunaan:

• "Gunakan prompt market_scan untuk menganalisis daftar pantau saya"
• "Pindai pasar saya untuk pengaturan trading"

Trading nyata: Ubah konfigurasi Anda menjadi: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - Alur Kerja Perencanaan Trading

Memandu Anda melalui pembuatan proposal trading dengan alat manajemen risiko.

Parameter:

• epic - Pasar untuk diperdagangkan (diperlukan, mis., SILVER, GOLD)
• direction - BUY atau SELL (default: BUY)
• thesis - Alasan trading Anda (opsional)
• risk_percent - Risiko sebagai % dari saldo (default: 1.0%)

Alur Kerja:

1. Ambil detail pasar dan aturan dealing
2. Hitung ukuran posisi berdasarkan % risiko
3. Tentukan level stop loss dan take profit
4. Pratinjau trading (hanya validasi - tanpa eksekusi)
5. Kembalikan preview_id untuk eksekusi potensial

Contoh Penggunaan:

• "Buat proposal trading untuk SILVER"
• "Usulkan trading long pada GOLD dengan risiko 2%"

Catatan: Prompt ini TIDAK mengeksekusi trading - hanya membuat pratinjau.

3. execute_trade - Alur Kerja Eksekusi Trading

Memandu Anda melalui eksekusi trading yang telah dipratinjau.

Parameter:

• preview_id - ID Pratinjau dari trade_proposal (diperlukan)

Alur Kerja:

1. Verifikasi preview_id disediakan dan valid
2. Periksa ulang semua kontrol risiko
3. Eksekusi posisi dengan broker
4. Polling untuk konfirmasi (ACCEPTED/REJECTED)
5. Laporkan status akhir

Contoh Penggunaan:

• "Eksekusi trading yang baru saja saya pratinjau"
• "Tempatkan trading dengan ID pratinjau abc-123"

Catatan:

• Memerlukan CAP_ALLOW_TRADING=true
• Memerlukan epic dalam daftar izin
• Pratinjau tidak boleh kedaluwarsa (TTL 2 menit)
• ⚠️ Ini AKAN menempatkan trading nyata

4. position_review - Alur Kerja Analisis Portofolio

Memandu Anda melalui analisis posisi dan pesanan terbuka Anda.

Parameter: Tidak ada (menganalisis semua posisi saat ini)

Alur Kerja:

1. Ambil semua posisi terbuka
2. Ambil semua pesanan kerja
3. Hitung metrik P&L, risiko, dan eksposur
4. Identifikasi risiko konsentrasi dan korelasi
5. Sarankan penyesuaian potensial (tanpa mengeksekusi)

Contoh Penggunaan:

• "Tinjau posisi saya saat ini"
• "Analisis eksposur portofolio saya"

Catatan: Ini adalah alur kerja hanya-baca - tidak ada trading yang dieksekusi.

5. live_price_monitor - Pelacakan Harga Real-Time (WebSocket)

Pantau harga pasar langsung dengan peringatan instan saat harga bergerak melampaui ambang batas.

Parameter:

• epics - Daftar EPIC pasar untuk dipantau (biarkan kosong untuk mencari/memilih, maks 40)
• duration_minutes - Berapa lama untuk memantau (default: 5 menit, maks: 10 menit)
• threshold_percent - Peringatkan saat harga bergerak > % ini (default: 1.0%)

Alur Kerja:

1. Pilih pasar untuk dipantau (atau berikan EPIC secara langsung)
2. Ambil harga awal untuk menetapkan baseline
3. Berlangganan pembaruan harga WebSocket real-time
4. Tampilkan papan harga langsung dengan pembaruan berkelanjutan
5. Peringatkan saat pasar mana pun bergerak > threshold_percent
6. Hentikan otomatis setelah duration_minutes

Contoh Penggunaan:

• "Pantau harga GOLD dan SILVER selama 2 menit"
• "Awasi BTC selama 5 menit ke depan, peringatkan pada pergerakan 2%" Catatan: Memerlukan CAP_WS_ENABLED=true. Sesi WebSocket Capital.com berlangsung maksimal 10 menit.

6. real_time_alerts - Peringatan Harga Bersyarat (WebSocket)

Tetapkan peringatan level harga dan dapatkan notifikasi instan saat pasar mencapai target Anda.

Parameter:

• alert_config - Level peringatan per EPIC (mis., {"GOLD": 2050.0, "SILVER": 28.5})
• duration_minutes - Durasi pemantauan maksimum (default: 5 menit)
• auto_stop - Hentikan pemantauan setelah peringatan pertama? (default: true)

Alur Kerja:

1. Konfigurasikan kondisi peringatan (level harga untuk setiap pasar)
2. Berlangganan pembaruan harga WebSocket
3. Pantau terus-menerus untuk pemicu peringatan
4. Kirim peringatan instan saat kondisi terpenuhi
5. Secara opsional lanjutkan pemantauan atau hentikan setelah peringatan pertama

Contoh Penggunaan:

• "Peringatkan saya saat GOLD mencapai 2050"
• "Beri tahu saat SILVER turun di bawah 28"

Catatan: Memerlukan CAP_WS_ENABLED=true.

7. live_portfolio_monitor - Pelacakan P&L Real-Time (WebSocket)

Pantau P&L portofolio Anda yang diperbarui secara real-time seiring pergerakan harga pasar.

Parameter:

• duration_minutes - Durasi pemantauan (default: 5 menit, maks: 10 menit)
• alert_pnl_threshold - Peringatkan saat total P&L melebihi jumlah ini (default: $100)

Alur Kerja:

1. Ambil posisi terbuka saat ini
2. Berlangganan pembaruan harga untuk pasar posisi
3. Hitung P&L langsung saat harga berubah
4. Tampilkan dasbor portofolio real-time
5. Peringatkan saat P&L melampaui ambang batas

Contoh Penggunaan:

• "Pantau P&L portofolio saya selama 5 menit"
• "Amati posisi secara real-time, peringatkan pada P&L $500"

Catatan: Memerlukan CAP_WS_ENABLED=true dan posisi aktif.

Cara Menggunakan Prompt

Di Claude Desktop atau klien MCP lainnya, prompt muncul sebagai pola interaksi yang tersedia. Anda dapat memanggilnya secara alami dalam percakapan:

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 memberikan panduan terstruktur sambil mempertahankan kontrol trading di seluruh alur kerja.

Sumber Daya MCP (Data Hanya-Baca)

Sumber daya MCP menyediakan akses hanya-baca ke status server dan konfigurasi melalui sumber daya berbasis URI. Tidak seperti alat (yang melakukan tindakan), sumber daya mengekspos data yang dapat dibaca dan dipantau oleh klien.

Sumber Daya yang Tersedia

1. cap://status - Status Server

Informasi server dan sesi real-time.

Mengembalikan: JSON dengan kesehatan server, status sesi, status autentikasi, batas laju

Contoh:

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

Kasus Penggunaan: Memantau kesehatan server, memeriksa status sesi, men-debug masalah autentikasi

---

2. cap://risk-policy - Kebijakan Risiko

Konfigurasi manajemen risiko komprehensif dan kontrol trading.

Mengembalikan: JSON dengan semua lapisan validasi, fitur kontrol trading, dan pembatasan trading

Contoh:

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

Kasus Penggunaan: Memahami kontrol trading aktif, mengaudit konfigurasi risiko, dokumentasi kepatuhan

---

3. cap://allowed-epics - Daftar Izin Trading

Konfigurasi daftar izin trading saat ini yang menunjukkan pasar yang diizinkan.

Mengembalikan: JSON dengan mode daftar izin, epic yang diizinkan, dan instruksi konfigurasi

Contoh:

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

Kasus Penggunaan: Memeriksa pasar mana yang dapat diperdagangkan, memverifikasi konfigurasi daftar izin

---

4. cap://market-cache/{epic} - Detail Pasar (Dinamis)

Detail pasar yang di-cache untuk epic tertentu (pengambilan langsung dari broker).

Parameter:

• epic - Pengidentifikasi pasar (mis., "GOLD", "SILVER", "CS.D.EURUSD.TODAY.IP")

Mengembalikan: JSON dengan informasi pasar yang komprehensif

Autentikasi: Diperlukan

Contoh: 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"
}

Kasus Penggunaan: Mendapatkan detail pasar, memeriksa aturan trading, menganalisis persyaratan margin

---

Cara Menggunakan Sumber Daya

Di Claude Desktop atau klien MCP lainnya, sumber daya dapat diakses melalui 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]

Sumber daya menyediakan cara yang nyaman untuk memeriksa status server dan konfigurasi tanpa menjalankan alat. Untuk data watchlist, gunakan alat cap_watchlists_list dan cap_watchlists_get.

Proses Eksekusi Trading

Eksekusi Dua Langkah Wajib

Semua operasi dengan efek samping menggunakan alur pratinjau → eksekusi yang ketat:

1. Pratinjau: Validasi trading terhadap aturan broker + kebijakan risiko lokal

   • Mengembalikan preview_id dengan permintaan yang dinormalisasi + pemeriksaan risiko
   • Tidak ada efek samping, validasi hanya-baca

2. Eksekusi: Kirim trading menggunakan preview_id

   • Menjalankan ulang pemeriksaan kritis
   • Memerlukan confirm=true jika CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Melakukan polling konfirmasi broker
   • Menambah penghitung pesanan harian

Kontrol Risiko

• Daftar Izin: Hanya EPIC di CAP_ALLOWED_EPICS yang dapat diperdagangkan
• Batas Ukuran: Ukuran posisi/pesanan maksimum ditegakkan
• Batas Posisi: Posisi terbuka maksimum setiap saat
• Batas Harian: Pesanan maksimum per hari
• Normalisasi Ukuran: Membulatkan ke min/maks/kenaikan broker
• Mode Dry-Run: Memblokir semua eksekusi saat diaktifkan

Dokumentasi

• Panduan Penggunaan: USAGE.md - Panduan penggunaan komprehensif dengan contoh
• Referensi API Capital.com: https://open-api.capital.com/
• Koleksi Postman API Capital.com: https://github.com/capital-com-sv/capital-api-postman

Lisensi

MIT

Penyangkalan – Penggunaan API Publik Capital.com dengan Alat Pihak Ketiga

Integrasi Pihak Ketiga

Halaman ini menjelaskan bagaimana klien dapat menghubungkan API Publik Capital.com ke perangkat lunak, alat, atau integrasi pihak ketiga, termasuk yang didukung oleh kecerdasan buatan atau model bahasa besar ('LLM'). Setiap perangkat lunak, alat, atau integrasi pihak ketiga tersebut independen dari Capital.com dan bukan merupakan bagian dari layanan Capital.com. Capital.com tidak mengendalikan, mengembangkan, mendukung, atau menerima tanggung jawab apa pun atas perangkat lunak pihak ketiga, fungsionalitasnya, keluarannya, atau hasil apa pun yang timbul dari penggunaannya. Setiap penggunaan alat atau integrasi pihak ketiga sehubungan dengan API Publik Capital.com sepenuhnya merupakan risiko Anda sendiri. Anda bertanggung jawab untuk meninjau ketentuan, kebijakan privasi, dan praktik penanganan data dari setiap alat pihak ketiga yang Anda pilih untuk digunakan.

Penggunaan API Publik

Penggunaan API Publik Capital.com sepenuhnya merupakan kebijaksanaan dan risiko Anda sendiri. Capital.com menyediakan API Publik untuk tujuan informasi dan trading tetapi tidak merekomendasikan, mendukung, atau mendorong penggunaan, integrasi, atau strategi trading tertentu. Anda bertanggung jawab penuh atas cara Anda mengakses dan menggunakan API, termasuk parameter pesanan apa pun yang dikirimkan, konfigurasi alat atau sistem yang terhubung, dan interpretasi data apa pun yang diterima. Capital.com tidak bertanggung jawab atas kerugian atau hasil yang tidak diinginkan yang timbul dari penggunaan API Anda, baik diakses secara langsung maupun melalui alat pihak ketiga. Ketersediaan, fungsionalitas, dan spesifikasi API dapat dimodifikasi, dibatasi lajunya, ditangguhkan, atau dihentikan kapan saja tanpa pemberitahuan sebelumnya. Penggunaan API Publik Anda tunduk pada Syarat dan Ketentuan serta Ketentuan Perdagangan Elektronik Capital.com, yang harus Anda baca dengan saksama sebelum menggunakan API.

Layanan Eksekusi-Saja dan Tidak Ada Saran Investasi Capital.com menyediakan layanannya berdasarkan eksekusi-saja. Perdagangan instrumen keuangan melibatkan risiko kerugian yang signifikan. Tidak ada apa pun di halaman ini, dalam API Publik, atau dalam perangkat lunak atau integrasi pihak ketiga mana pun yang merupakan saran investasi, rekomendasi pribadi, atau ajakan untuk membeli atau menjual instrumen keuangan apa pun. Ini termasuk keluaran, sinyal, saran, atau analisis apa pun yang dihasilkan oleh AI, berbasis LLM, atau alat otomatis lainnya. Semua keputusan trading, termasuk aktivitas otomatis atau algoritmik apa pun, dibuat atas risiko Anda sendiri dan tetap menjadi tanggung jawab Anda sepenuhnya. Risiko Perdagangan Otomatis dan Algoritmik Penggunaan API Publik sehubungan dengan alat perdagangan otomatis atau algoritmik membawa risiko tambahan, termasuk namun tidak terbatas pada: eksekusi pesanan yang cepat tanpa tinjauan atau intervensi manusia; kesalahan sistem, kegagalan perangkat lunak, atau masalah konektivitas; eksekusi pada harga yang berbeda secara material dari yang diharapkan; dan pesanan yang tidak disengaja atau salah akibat alat atau parameter yang salah konfigurasi. Capital.com tidak bertanggung jawab atas kerugian apa pun yang timbul dari risiko tersebut atau dari interaksi antara sistemnya dan alat pihak ketiga mana pun. Kinerja masa lalu dan keluaran apa pun yang dihasilkan oleh alat otomatis tidak menunjukkan hasil di masa depan.

Penggunaan yang Dilarang

Penggunaan API Publik dan alat yang terhubung tidak boleh digunakan untuk memanipulasi platform Capital.com, mengeksploitasi harga atau latensi, terlibat dalam penyalahgunaan pasar, atau memperoleh keuntungan yang tidak adil. Capital.com berhak untuk membatasi, menangguhkan, atau mengakhiri akses API dan/atau akun Anda jika dianggap wajar bahwa penyalahgunaan tersebut telah terjadi atau mungkin terjadi. Klien tidak boleh mengizinkan pihak ketiga mana pun untuk melakukan kontrol diskresioner atas akun mereka.

Tanggung Jawab Anda

Anda bertanggung jawab untuk memastikan bahwa penggunaan platform Capital.com, API Publik, dan alat atau integrasi pihak ketiga apa pun mematuhi Syarat dan Ketentuan Capital.com, Ketentuan Perdagangan Elektronik, dan semua hukum dan peraturan yang berlaku di yurisdiksi Anda. Anda harus mempertimbangkan dengan saksama apakah alat perdagangan otomatis sesuai dengan keadaan, pengalaman, dan toleransi risiko Anda sebelum menggunakannya. Capital.com sangat menyarankan Anda menguji alat atau integrasi otomatis apa pun secara menyeluruh menggunakan akun Demo sebelum menghubungkannya ke lingkungan trading langsung.