Home

capctl wiki

Unofficial command-line client (and async Python SDK) for the Capital.com Open API — market data, guarded order execution, watchlists, and real-time streaming, from your terminal.

Unofficial. Not affiliated with, endorsed by, or sponsored by Capital.com. CFD trading carries a high risk of losing money. capctl defaults to the demo environment and keeps trading off until you explicitly opt in.

📖 This wiki is a signpost. The authoritative, version-matched docs live in the repository under docs/ — they're reviewed alongside the code and always match the release you installed. Start there for anything canonical; use this wiki for the FAQ and quick orientation.

Install

pipx install capitalcom-cli               # recommended (isolated global command)
uv tool install capitalcom-cli            # or, with uv
brew install SimonTarara62/tap/capctl     # macOS/Linux, via Homebrew

Then capctl --help. New to it? Follow Getting started below — it goes from no account and no API key to your first practice trade on a demo account.

Documentation

Start here

• Getting started — zero to your first demo trade
• FAQ — common questions (this wiki)

Using it

• Practical use cases
• Scripting & automation
• Command reference
• Troubleshooting & exit codes

Building on it

• Use as a library (SDK)
• API coverage matrix

Project

• Security & safety model
• Installation channels
• Contributing
• Changelog