Personal Script

Spread Trading System

Catch price discrepancies between MEXC and DEX automatically. The scanner spots Futures vs Spot and Futures vs DEX divergences; the bundled bot executes trades on every Futures-DEX signal that passes your filters.

Monitor Price Spreads Across Markets

Pulls live prices from MEXC Futures, MEXC Spot and DexScreener in real time and computes pairwise spreads each tick. Every spread above your threshold becomes a tracked event with START → UPDATE → END or REVERSAL stages.

Full Event Lifecycle Tracking

Every spread is tracked from detection to trade close. Telegram notifications refresh on every price move greater than 0.5%.

1

START

Spread between two markets exceeds MinSpreadPercent. Event created with direction (Futures premium or discount).

2

UPDATE

Continuous monitoring while spread is active. Each update reports current spread %, direction, and duration.

3

END

Spread drops below threshold or data becomes stale. Event closed with final stats and duration.

4

REVERSAL

If spread direction flips (premium ↔ discount), the old event ends and a new one starts automatically.

Everything You Need to Run Independently

📡

Parser Script

Spread detection engine monitoring Futures, Spot and DEX prices with full lifecycle management.

Trading Bot Script

Auto-execution on spread events — enters positions on MEXC when spread opportunity is detected.

🤖

Telegram Bot

Full configuration and alerts via Telegram. Manage spread thresholds and receive lifecycle updates.

Documentation

Step-by-step setup guide, configuration reference and troubleshooting — everything to get running in minutes.

Fully Configurable Parameters

Every parameter — spread threshold, monitoring modes, filters, grid entry, take-profit and stop-loss — is configured via .env or the Telegram bot. No code edits, all changes apply on the fly.

  • MinSpreadPercent — minimum spread % to trigger signal
  • Monitoring modes — Futures-Spot and Futures-DEX, toggleable independently (trades execute on DEX signals only)
  • Whitelist / Blacklist — monitor or exclude specific tokens
  • Grid entry — averaging steps with configurable step % and volume per step
  • Take-profit — multi-step TP levels, fixed or dynamic percent
  • Stop-loss — market or limit, configurable percent from entry
  • Leverage & sizing — per-strategy leverage and position volume

Simple Setup, No Overhead

Runs anywhere Python runs. No Docker, no containers, no complex infrastructure.

  • Python 3.11+ required
  • SQLite — zero-config database included
  • No Docker required
  • Runs on any VPS (Ubuntu, Debian, etc.)
  • Simple startup: python run.py
  • Minimal resource usage

Get Spread Scanner Script

Deploy the spread scanner and trading bot on your server as a standalone script.