acaprino/mt5-trading
plugins/mt5-trading/skills/mt5-trading/SKILL.md
Comprehensive MetaTrader 5 Python algotrading knowledge base covering the official synchronous API, polling-based event systems, order execution with fill modes, historical data functions, reconnection resilience, and Windows production deployment. Includes aiomql and ZeroMQ bridge alternatives. TRIGGER WHEN: building, implementing, writing, coding, creating, optimizing, or debugging MT5 trading systems with Python. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.
$ install --global
skillsauthnpx skillsauth add acaprino/anvil-toolset mt5-tradingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 11, 2026, 4:50 AM383.3s6 files scanned
SKILL.md
- name:
- mt5-trading
- description:
- >
- TRIGGER WHEN:
- building, implementing, writing, coding, creating, optimizing, or debugging MT5 trading systems with Python.
- DO NOT TRIGGER WHEN:
- the task is outside the specific scope of this component.
MetaTrader 5 Python Algotrading
Knowledge base for building production-grade algorithmic trading systems with MetaTrader 5 Python API.
When to Use
- Connecting to MT5 terminal via the official Python API
- Building polling-based event systems (on_tick, on_new_candle, on_position)
- Executing orders with correct fill modes (FOK, IOC, Return)
- Downloading historical data (copy_rates, copy_ticks)
- Handling MT5 disconnections and terminal restarts
- Deploying MT5 bots on Windows with process monitoring
- Choosing between official API, aiomql, and ZeroMQ bridge
Quick Start
For 80% of use cases, start with:
- Library:
pip install MetaTrader5(official) orpip install aiomql(async wrapper) - Connection:
mt5.initialize(path=..., login=..., server=..., password=...) - Event system: polling loop with candle/tick/position change detection
- Orders:
order_check()beforeorder_send(), always detect fill mode dynamically - Risk: server-side SL/TP on every position (non-negotiable)
- Resilience: health check every 30-60s, psutil process monitoring, exponential backoff
Then harden incrementally:
- Silent errors -- wrap every API call with None check + last_error()
- Fill mode rejections (10030) -- dynamic filling_mode detection per symbol
- Terminal crashes -- psutil watchdog + subprocess restart
- Weekend handling -- datetime.weekday() sleep mode
Reference Materials
api-architecture.md-- MT5 Python API architecture, 32 functions, named pipes IPC, MQL5 EA vs Python, library comparisonevent-system-polling.md-- polling patterns, new candle detection, tick monitoring, position tracking, concurrency rulesorder-execution.md-- order_send, fill modes (FOK/IOC/Return), hedging vs netting, retcodes, risk checks, magic numbersdata-feed-historical.md-- copy_rates, copy_ticks, depth, timezone caveats, caching, data quality, broker differencesproduction-resilience.md-- disconnection handling, reconnection, weekend management, Windows deployment, community resources
Key Decision Points
| Decision | Default | Upgrade When | |----------|---------|-------------| | Library | Official MetaTrader5 | Need async: aiomql. Need true streaming: ZeroMQ bridge | | Event model | Polling (1-5s interval) | Tick-sensitive: poll 100-250ms. True events: ZeroMQ EA bridge | | Fill mode | Detect dynamically per symbol | Never hardcode -- changes between brokers/symbols | | Account mode | Hedging (most forex brokers) | Check account_info().margin_mode at startup | | Data caching | Parquet + Zstandard | Tick data -- partition by day/month | | Concurrency | asyncio (single thread) | Multi-account -- separate processes per terminal | | Backtesting | Python framework (Backtrader, Backtesting.py) | Need MT5 tester -- MQL5 EA wrapper | | SL/TP | Server-side always | Python trailing only as supplement, never as sole protection |
Related Skills
acaprino/memory-forensics
tools
VerifiedTrustedCommunity
Master memory forensics techniques including memory acquisition, process analysis, and artifact extraction using Volatility and related tools. Use when analyzing memory dumps, investigating incidents, or performing malware analysis from RAM captures.
5SKILL.mdUpdated May 13, 2026
acaprino/binary-analysis-patterns
development
VerifiedTrustedCommunity
Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.
5SKILL.mdUpdated May 13, 2026
acaprino/kotlin-specialist
development
VerifiedTrustedCommunity
Idiomatic Kotlin implementation patterns: coroutines and structured concurrency, Flow / StateFlow / SharedFlow, Kotlin Multiplatform (KMP) shared-code architecture, Jetpack Compose UI, Ktor server with JWT auth and Exposed, and type-safe DSL design (lambdas with receivers, delegated properties, inline reified, value classes). TRIGGER WHEN: building, writing, or reviewing Kotlin code using coroutines / Flow / suspend functions, expect/actual, Compose composables / ViewModels, Ktor routing, sealed-class state modeling, scope functions, or DSL builders. DO NOT TRIGGER WHEN: libGDX game work (use libgdx-development), Android Java without Kotlin, or pure JVM tuning unrelated to Kotlin language features.
5SKILL.mdUpdated May 13, 2026
acaprino/frontend-strategy
tools
VerifiedTrustedCommunity
Strategic website planning skill that conducts structured client discovery, produces professional deliverables (website brief, sitemap, design direction, content strategy), and orchestrates frontend-design, frontend-layout, seo-specialist, and content-marketer agents automatically. TRIGGER WHEN: planning a new website or redesign before any code is written. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.
5SKILL.mdUpdated May 13, 2026