@5326/Fvg Delta Forex Engine

Name: @5326/Fvg Delta Forex Engine
Author: starchild-ai-agent

starchild-ai-agent/community-skills

1 installs
1 repo stars
Updated July 29, 2026
starchild-ai-agent/community-skills

Scan forex, metals, energy, and indices on 15m candles with a five-stage FVG/SMC engine, pip-based risk, market clock, and news radar.

About

A FastAPI service that runs the FVG-Delta five-stage Smart-Money-Concept engine on forex majors, metals, energy, and indices using keyless Yahoo Finance 15m data. A developer uses it to run a forex signal engine with pip-based risk sizing, a market clock, and a news radar.

Same five-stage SMC strategy applied to forex, metals, energy, indices
Yahoo Finance 15m data plus ForexFactory news radar and market clock

@5326/Fvg Delta Forex Engine by the numbers

1 all-time installs (skills.sh)
Ranked #909 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
Data as of Jul 30, 2026 (Skillselion catalog sync)

npx skills add https://github.com/starchild-ai-agent/community-skills --skill fvg-delta-forex-engine

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/starchild-ai-agent/community-skills/fvg-delta-forex-engine.svg)](https://skillselion.com/skills/starchild-ai-agent/community-skills/fvg-delta-forex-engine)

Installs	1
repo stars	★ 1
Last updated	July 29, 2026
Repository	starchild-ai-agent/community-skills ↗

What it does

Scan forex, metals, energy, and indices on 15m candles with a five-stage FVG/SMC engine, pip-based risk, market clock, and news radar.

Files

SKILL.mdMarkdownGitHub ↗

FVG-Delta Forex Signal Engine v6.0

A production FastAPI service that scans the global forex market on 15-minute candles, runs a strict lock-forward Smart-Money-Concept (SMC) staged state machine, and alerts on the late stages. It is the forex evolution of the FVG-Delta crypto engine — identical strategy, refined for forex speed and mechanics.

What it scans

A curated, liquidity-screened universe (no illiquid exotics, no single stocks), defined in assets/instruments.py:

FX majors & minors (EUR/USD, GBP/JPY, EUR/GBP, …)
Metals (XAU/USD gold, XAG/USD silver)
Energy (WTI, Brent, NatGas)
Indices (NAS100, S&P500, US30, DAX, FTSE100, Nikkei225, DXY)

Data is pulled from Yahoo Finance via yfinance — real 15m OHLC, no API key.

The strategy (unchanged from crypto)

Stage 0 FVG/impulse context → Stage 1 first-liquidity lock + BoS close → Stage 2 liquidity sweep (close-through) → Stage 3 FVG interaction → Stage 4 opposite-direction confirmation = verified entry. Lock-forward: each transition is searched once and locked; stages never silently regress.

Forex refinements

Risk model: pips / lot (default micro 0.01) / LEVERAGE (default 500,

margin only) / required margin / $ risk-reward (P/L = pips × pip-value × lots). Spread-aware. Replaces the crypto ROI/auto-leverage model.

Intrabar Stage 3 + exits: FVG touch registers on the forming candle; SL /

TP / Break-even fire intrabar. Structural stages (1/2) stay close-based.

No TTL on Stage 3/4: they resolve only on real triggers (Stage 3: close

through FVG; Stage 4: SL / TP / Break-even).

Market clock: Open/Closed badge, weekend + holidays, browser-tz countdown.
News radar: ForexFactory weekly feed graded Safe / Caution / No-Trade with

a short label + countdown, shown on the dashboard and inside Telegram alerts.

Run it

# 1. credentials (never paste keys in chat — use the secure env flow)
cp .env.example .env   # set TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID; optional LEVERAGE / LOT_SIZE
# 2. local
bash assets/run_one_shot.sh
# 3. docker / Hugging Face Spaces (Docker SDK)
docker build -t fvg-forex assets/ && docker run -p 7860:7860 --env-file .env fvg-forex

Endpoints: / (dashboard), /health, /api/state, /api/market, /api/news, /api/chart.png?symbol=EUR/USD. Without Telegram creds the UI still runs; alerts are skipped and logged.

Tuning & gotchas

All knobs are env vars with production-safe defaults — see

assets/VARIABLES_AND_SECRETS_GUIDE.txt.

Structural stages (1/2) decide on the last CLOSED candle (bars[-2]); Stage-3

touch and SL/TP/BE use the forming candle (bars[-1]) when INTRABAR_* is on.

Cron/weekly times are UTC. The dashboard renders all times + countdowns in the

viewer's browser timezone.

yfinance needs outbound access to Yahoo; the news radar needs ForexFactory.

Both are keyless. If a feed is unreachable the engine degrades gracefully.

Pip values are broker-approximate defaults (override via FVG_PIPVAL_<PAIR>).

Files (in `assets/`)

app.py (engine), instruments.py, market_clock.py, economic_calendar.py, risk_forex.py, Dockerfile, start.sh, run_one_shot.sh, preflight_check.py, requirements.txt, AGENT.md (maintainer guide), STRATEGY_DETAILED_SPEC.txt, VARIABLES_AND_SECRETS_GUIDE.txt, README.md. Read assets/AGENT.md before editing app.py.