{"id":46402,"library":"smartmoneyconcepts","title":"Smart Money Concepts","description":"A Python library to compute indicators based on Smart Money Concepts (SMC) and ICT (Inner Circle Trader) trading methodologies. Version 0.0.27 provides tools for identifying market structure, order blocks, fair value gaps, and liquidity levels. Rapidly evolving with frequent releases.","status":"active","version":"0.0.27","language":"python","source_language":"en","source_url":"https://github.com/joshyattridge/smartmoneyconcepts","tags":["smart-money-concepts","ict","trading","indicators","market-structure","order-blocks"],"install":[{"cmd":"pip install smartmoneyconcepts","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Numerical computations","package":"numpy","optional":false},{"reason":"DataFrame handling","package":"pandas","optional":false}],"imports":[{"note":"The package structure expects a submodule; direct import of 'smc' fails.","wrong":"import smc","symbol":"smc","correct":"import smartmoneyconcepts.smc as smc"},{"note":"Submodule must be imported from the package.","wrong":"import indicators","symbol":"indicators","correct":"from smartmoneyconcepts import indicators"}],"quickstart":{"code":"import pandas as pd\nimport numpy as np\nimport smartmoneyconcepts.smc as smc\n\n# Sample OHLC data\ndata = pd.DataFrame({\n    'open': np.random.uniform(100, 110, 100),\n    'high': np.random.uniform(110, 120, 100),\n    'low': np.random.uniform(90, 100, 100),\n    'close': np.random.uniform(100, 110, 100),\n    'volume': np.random.randint(1000, 5000, 100)\n})\n\n# Compute order blocks\norder_blocks = smc.order_blocks(data, join_consecutive=True)\nprint(order_blocks.head())","lang":"python","description":"Computes order blocks from OHLCV data using a simple random dataset."},"warnings":[{"fix":"Pin to exact version: smartmoneyconcepts==0.0.27","message":"The library is in early development (v0.x). Breaking API changes occur frequently without deprecation warnings. Always pin your dependency version.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Always refer to the official documentation or README for current function signatures.","message":"Function parameters and defaults may change. For example, `join_consecutive` in `order_blocks` was added in v0.0.26; older code without it may produce different results.","severity":"gotcha","affected_versions":"All"},{"fix":"Ensure your DataFrame contains exactly those column names and correct data types.","message":"The library expects data in a specific OHLCV format with columns: 'open', 'high', 'low', 'close', 'volume'. Missing or misnamed columns cause unhelpful KeyErrors.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"search_vec":"'0.0.27':24 'base':10 'block':32,56 'circl':19 'comput':8 'concept':3,14,47 'evolv':40 'fair':33 'frequent':42 'gap':35 'ict':17,48 'identifi':28 'indic':9,50 'inner':18 'level':38 'librari':6 'liquid':37 'market':29,52 'market-structur':51 'methodolog':22 'money':2,13,46 'order':31,55 'order-block':54 'provid':25 'python':5 'rapid':39 'releas':43 'smart':1,12,45 'smart-money-concept':44 'smc':15 'structur':30,53 'tool':26 'trade':21,49 'trader':20 'valu':34 'version':23","created_at":"2026-06-07T12:59:44.822855+00:00","updated_at":"2026-06-07T12:59:44.822855+00:00","problems":[{"fix":"Use: import smartmoneyconcepts.smc as smc","cause":"Incorrect import path; the submodule must be imported explicitly.","error":"ImportError: cannot import name 'smc' from 'smartmoneyconcepts'"},{"fix":"Rename columns to 'open','high','low','close','volume'.","cause":"DataFrame missing required OHLCV columns or columns have wrong names.","error":"KeyError: 'high'"},{"fix":"Clean your data: fill or drop NaNs with df.dropna() before passing to library functions.","cause":"Typically caused by NaN handling or invalid data; some indicators require non-NaN data.","error":"ValueError: Length of values does not match length of index"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/joshyattridge/smartmoneyconcepts","github":"https://github.com/joshyattridge/smartmoneyconcepts","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["analytics"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}