smc

Detect BOS, ChoCH, FVG, and order block signals from OHLCV pandas DataFrames.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ebrahim-sani/trading-automation --skill smc-ebrahim-sani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smc
Source: https://github.com/ebrahim-sani/trading-automation/tree/main/vibe-trading/agent/src/skills/smc
Command: npx skills add https://github.com/ebrahim-sani/trading-automation --skill smc-ebrahim-sani

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides an automated, programmatic way to detect institutional Smart Money Concepts (SMC) signals such as Break of Structure (BOS), Change of Character (ChoCH), Fair Value Gaps (FVG), and Order Blocks (OB), eliminating manual chart inspection and reducing missed or noisy signals.

Core Features & Use Cases

  • SMC signal generation: Implements BOS/ChoCH detection, FVG identification, and order block logic to derive directional signals.
  • Data robustness: Accepts OHLCV pandas DataFrames with resilient column mapping and a volume fallback for feeds without tick volume.
  • Outputs & integration: Emits time-aligned signals (1 = long, -1 = short, 0 = stand aside) suitable for algorithmic trading, backtesting, or journaling workflows; configurable via swing_length and close_break.
  • Use case: Integrate with a local strategy engine to filter trade entries by institutional-structure confirmation or to journal structural events for post-trade analysis.

Quick Start

Generate SMC signals by running the SignalEngine on a mapping of instrument symbols to OHLCV pandas DataFrames to receive 1 for long, -1 for short, and 0 to stand aside.

Frequently Asked Questions about smc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect Smart Money Concepts like BOS and ChoCH from OHLCV pandas DataFrames?

You can detect Smart Money Concepts by processing OHLCV pandas DataFrames through a signal engine that identifies Break of Structure (BOS), Change of Character (ChoCH), Fair Value Gaps (FVG), and order blocks programmatically. It outputs time-aligned directional signals (1 for long, -1 for short, 0 for stand aside).

Can I use SMC signal generation for algorithmic trading backtesting?

Yes, SMC signal generation is designed for algorithmic trading, backtesting, and journaling workflows. The engine emits time-aligned directional signals based on configurable swing_length and close_break parameters, which can be integrated directly into a local strategy engine for trade entry filtering.

What happens if my OHLCV data feed does not include tick volume?

If your OHLCV data feed lacks tick volume, the signal engine utilizes a volume fallback mechanism. This ensures robust data processing and accurate structural event detection, allowing SMC signal generation to continue functioning without missing or noisy signals.

How do I configure swing length and close break parameters for order block detection?

Order block detection and other SMC signals can be configured using the swing_length and close_break parameters within the signal engine. These settings adjust the sensitivity of structural event detection, allowing you to tailor the time-aligned 1, -1, and 0 outputs to your specific timeframe analysis.

Does the Smart Money Concepts signal engine support multi-instrument timeframe analysis?

Yes, the signal engine supports multi-instrument timeframe analysis by accepting a mapping of instrument symbols to OHLCV pandas DataFrames. This allows you to run SMC signal generation, including BOS, ChoCH, and FVG detection, across multiple assets simultaneously for comprehensive algorithmic trading.

What is the best way to automate institutional order block detection instead of manual chart inspection?

The best way to automate order block detection is by applying a programmatic signal engine to OHLCV price series, which eliminates manual chart inspection and reduces missed or noisy signals. This approach integrates with the smartmoneyconcepts Python library to derive directional trading signals automatically.