Metadata-Version: 2.4
Name: trading-matrix-dashboard
Version: 2.0.0
Summary: An algorithmic crypto & commodities auto-execution Streamlit dashboard.
Author-email: Shashank Joshi <shashankjoshi61@yahoo.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: streamlit>=1.35.0
Requires-Dist: ccxt>=4.2.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: plotly>=5.15.0
Requires-Dist: requests>=2.31.0
Requires-Dist: streamlit-autorefresh==1.0.1
Dynamic: license-file

# Trading Matrix Dashboard
Run `trading-matrix` in your terminal after installation to launch the algorithmic execution board!
*** don't run this into root/admin user***

Algo Execution Matrix

A Streamlit dashboard for live market monitoring, volume-spike analysis, Telegram alerts and optional automated order execution.

Covers Bitcoin, Ethereum, Gold, Silver and Crude Oil with live bid/ask, a trendline/EMA strategy, and a volume-spike radar that logs unusual buying and selling activity to a JSON file.

Disclaimer: This software is for educational and research purposes only. It is not financial advice. Trading carries a high risk of loss. Auto-trading can place real orders with real money. Always test in paper mode first. The authors accept no liability for any losses.

Features
Live bid / ask for Gold, Silver and Crude Oil (Binance Futures first, Yahoo Finance as fallback) and BTC/ETH (Binance Spot): bid, ask, mid, spread and order-book imbalance.
Market direction score from order-book pressure, recent tick movement, price vs 20 EMA and 10-candle delta.
Strategy signals: angled trendline breakout, support bounce, resistance rejection, volume-drop warning, with optional delta confirmation.
Volume Spike Radar
Detects candles with volume more than 2X the average of the previous 200 candles.
Red candle is tagged seller, green candle is tagged buyer.
Dropdown filter for 2X / 3X / 4X / 5X strength.
Logs every spike (spot price, high/low range, volume, ratio, level) to volume_spikes.json.
Top-10 volume table, buyer vs seller pressure, and a Next move reading (breaking up, breaking down, leans up, leans down, range-bound) with support and resistance levels.
Statistics by spike band and JSON download of the filtered data.
Spike markers drawn on the candle chart.
Telegram alerts for new volume spikes, outlook changes, volume drops, strong direction scores and strategy signals. Alerts fire only when a condition switches on, so there is no spam.
Optional auto-trading through ccxt (Delta Exchange India, CoinDCX, Binance, Bybit). Off by default; paper mode is on by default; at most one order per candle per side.



Then open the local URL Streamlit prints (usually http://localhost:8501).

Pick an asset and candle timeframe in the sidebar.
Choose the spike strength (2X to 5X).
Optional: open the Telegram Alerts Config tab and enter your bot token and chat ID.
Optional: open the Broker API & Auto-Trade tab, connect your API keys and keep Paper mode on until you are happy with the behaviour.
Setting up Telegram
Message @BotFather on Telegram, create a bot and copy the token.
Send any message to your bot (or add it to a group), then find your chat ID (for example via https://api.telegram.org/bot<TOKEN>/getUpdates).
Enter both values in the Telegram tab and press Dispatch Test System Sync Message.
Data files
File	Purpose
volume_spikes.json	Log of every volume spike above 2X, created next to the script

Example record:

json
{
  "id": "Gold Spot|1h|1767225600000",
  "asset": "Gold Spot",
  "timeframe": "1h",
  "time": "2026-01-01 00:00:00",
  "tag": "buyer",
  "volume": 18250.0,
  "avg_volume_200": 4120.5,
  "ratio": 4.43,
  "level": "4X",
  "high": 4180.2,
  "low": 4161.7,
  "close": 4176.9,
  "spot_price": 4176.9
}

Times are in UTC.

How the Next-move reading works

Using the 10 highest-volume spikes for the selected asset and timeframe:

Breaking up: price is above every seller-spike zone.
Breaking down: price is below every buyer-spike zone.
Leans up / down: buyer or seller volume dominates by more than 25%.
Range-bound: neither side dominates.

This is a rule-based reading of volume zones, not a prediction. Confirm with your own analysis.

Limitations
Spike scanning and alerts only run while the dashboard is open in a browser tab.
Each data fetch returns about 200 candles, so the oldest candles are compared against a shorter average (minimum 50).
Yahoo Finance data can be delayed and may not provide a real bid/ask for futures; the app then shows the last price and a warning.
Some exchanges restrict access by region. If a source fails, the app falls back or shows an error.
Contract symbols differ between brokers; set the Execution symbol field to match your broker.
Shark Exchange / MT5 is not supported.
Security
API keys and tokens are held in Streamlit session memory only and are not written to disk by this app.
Use API keys with trade-only permission and withdrawals disabled.
Never commit keys or tokens to version control.
Contributing

Issues and pull requests are welcome. Please describe the change and how you tested it.
