Blueprint Eclipse Detector
Get this and other exclusive indicators in Blueprint Research
This indicator is part of BlueprintResearch's Paid Space. Subscribe for $33.00/month to use it on your charts along with the author's other exclusive indicators. You pay right on TradingView and get access straight away.
Explore Blueprint Research█ Blueprint Eclipse Detector finds every solar and lunar eclipse directly from planetary positions computed on your chart — no hardcoded date lists. Each event is refined to minute-level timing and classified by its full astronomical type: Total, Annular, or Partial for solar eclipses; Total, Partial, or Penumbral for lunar eclipses. Historical eclipses are marked across roughly 75 years of daily history; future eclipses are projected up to 2 years ahead; and every marker carries a complete planetary snapshot of the eclipse moment.
Powered by the open-source Blueprint Ephemeris library (VSOP87D + ELP2000-82 + Meeus) — all planetary positions computed directly in Pine Script, no external data required. Validated against NASA's DE440 ephemeris: all bodies under 0.1° RMS (Sun 0.004°, planets 0.005°–0.017°, Moon 0.062°, Pluto 0.059°).
Because everything is computed rather than looked up, the detector works on any symbol and any date range — and you can verify it yourself: two built-in validation tables compare the script's detections against NASA's eclipse catalog, covering 32 known eclipses from 1901 to 2025 across all six types.
█ HOW IT WORKS
1. Detection & Timing
The script evaluates the sky astronomically as your chart advances and identifies each eclipse individually, pinpointing each event to the minute of its closest approach. Nothing is looked up: any symbol, any era, the events emerge from the computed planetary positions themselves.
2. Classification
Each detected event is classified into its true astronomical type — Total, Annular, or Partial for solar; Total, Partial, or Penumbral for lunar — and borderline alignments that do not produce an eclipse are correctly rejected. The type is computed per event, not assigned from a list, which is exactly why the built-in validation tables can check it against NASA's catalog on any chart.
3. Placement
Eclipses land on calendar time, but markets don't trade every day. When an eclipse falls on a weekend, the marker is placed on the next trading session — never the prior bar — so the chart shows the first session that could react. 24/7 markets are automatically detected and retain the exact calendar date.
4. The Eclipse Moment Snapshot
Hover any marker for the full state of the sky at the eclipse: the eclipse type and precise date/time in your chosen timezone, Sun and Moon zodiac positions to the arc-minute, all eight planets with retrograde flags, both lunar nodes, and every active planetary aspect at that moment, sorted by tightest orb first.
█ FEATURES
Six Eclipse Types, Individually Colored
• Solar: Total (TSE), Annular (ASE), Partial (PSE)
• Lunar: Total (TLE), Partial (PLE), Penumbral (PENLE)
• Independent color control per type; solar and lunar layers toggle separately
Historical Markers
• Roughly 75 years of eclipse markers on daily charts, each with the full planetary tooltip
• Optional vertical eclipse lines through the chart
• Marker placement: above bar, below bar, chart top or bottom, or a fixed price level
Future Projections
• Forward scan up to two years ahead with the same refine-and-classify pipeline as historical detection
• Dashed projection lines with type-labeled markers and date labels
• Automatically clipped to TradingView's drawing horizon (500 bars past the last bar)
Planetary Relationships
• Every active aspect among the Sun, Moon, planets, and lunar nodes at the eclipse moment — conjunction, opposition, trine, square, sextile — is listed in the tooltip, with the tightest orb first
• Geocentric or heliocentric coordinate mode
Verification Built In
• Validation table, 2022–2025: 16 recent eclipses vs. NASA's catalog — expected vs. detected type and zodiac degree, pass/fail per row
• Historical validation table, 1901–1984: 16 eclipses from NASA's Five Millennium Catalog spanning all six types
• Both tables render live from the same code that detects your chart's eclipses — nothing is pre-recorded
Display & Alerts
• Timezone selection for all displayed times (exchange, UTC, or 11 major zones)
• Info table with layer status, look-ahead horizon, and live Sun–Moon separation
• Alert on every detected eclipse with type, zodiac position, date, and orb
█ HOW TO USE
1. Add the indicator to a Daily (1D) chart. Historical eclipse markers appear immediately; the tool is built for the daily timeframe and will tell you if the chart is set to anything else.
2. Hover any marker to read the eclipse moment snapshot — type, exact time, zodiac positions, retrogrades, nodes, and active aspects.
3. Check the future projections ahead of the current bar: dashed lines mark each upcoming eclipse with its type and date.
4. Choose your display timezone so eclipse times match your working clock.
5. To verify accuracy, enable the validation tables in Settings and compare the script's detections against NASA's catalog, row by row, on your own chart.
6. Enable alerts to be notified as each new eclipse is detected at its exact moment of closest approach.
7. Study how your market has behaved around past eclipses of each type — the per-type colors make it easy to separate total solar eclipses from penumbral lunars at a glance.
█ WHAT MAKES THIS ORIGINAL
Most eclipse indicators on TradingView are hardcoded date lists — a fixed table of events pasted into the code, valid only for the years the author transcribed, with no type information and nothing to verify. This detector computes eclipses from first principles, on the chart, from planetary positions.
Key contributions:
• Live astronomical detection — eclipses and their minute-level timing are computed from planetary positions on any symbol and any era, not transcribed from a catalog
• Per-event type classification — all six solar and lunar types determined computationally, with borderline non-eclipses correctly rejected
• Self-validating design — two built-in tables check the detector against 32 NASA-cataloged eclipses (1901–2025) using the same live code path, so accuracy is inspectable rather than claimed
• Trading-calendar placement — weekend eclipses land on the next trading session, with 24/7 markets auto-detected
• Complete eclipse-moment snapshot — every marker carries all planetary positions, retrogrades, nodes, and active aspects at the refined instant, not just a date stamp
█ LIMITATIONS & TIPS
• Daily (1D) charts only. Weekly and monthly bars sample the Moon's 29.5-day cycle too coarsely and would skip events, so the script gates itself to the daily timeframe.
• Historical markers use TradingView labels, which are capped at 500. On very long daily histories, this covers approximately the most recent 75 years. The validation tables go back further (to 1901) because they are computed, not drawn.
• Future projections extend to TradingView's drawing horizon of 500 bars past the last bar.
• Eclipse visibility is not modeled: this tool reports that an eclipse occurs and what type it is astronomically, not whether it is observable from a particular location.
• The eclipse markers are astronomical events, not signals. Whether and how a market responds to them is the study this tool exists to support.
• For mission-critical timing, cross-reference professional sources such as JPL Horizons, the Swiss Ephemeris, or NASA's eclipse catalog.
█ EPHEMERIS LIBRARY
The astronomical engine is the fully open-source Blueprint Ephemeris library, publicly available for study, modification, and reuse:
• BlueprintResearch/blueprint_ephemeris_lib — VSOP87D (planets), ELP2000-82 (Moon), Meeus (Pluto), validated against NASA JPL's DE440
█ CREDITS & REFERENCES
• Blueprint Ephemeris by BlueprintResearch — the open-source astronomical engine this detector is built on
• Validation targets drawn from NASA's eclipse catalog and Five Millennium Catalog of Solar Eclipses
█ ACCESS
This is an invite-only script. Access is provided through the Blueprint Research Paid Space on TradingView.
Powered by the open-source Blueprint Ephemeris library (VSOP87D + ELP2000-82 + Meeus) — all planetary positions computed directly in Pine Script, no external data required. Validated against NASA's DE440 ephemeris: all bodies under 0.1° RMS (Sun 0.004°, planets 0.005°–0.017°, Moon 0.062°, Pluto 0.059°).
Because everything is computed rather than looked up, the detector works on any symbol and any date range — and you can verify it yourself: two built-in validation tables compare the script's detections against NASA's eclipse catalog, covering 32 known eclipses from 1901 to 2025 across all six types.
█ HOW IT WORKS
1. Detection & Timing
The script evaluates the sky astronomically as your chart advances and identifies each eclipse individually, pinpointing each event to the minute of its closest approach. Nothing is looked up: any symbol, any era, the events emerge from the computed planetary positions themselves.
2. Classification
Each detected event is classified into its true astronomical type — Total, Annular, or Partial for solar; Total, Partial, or Penumbral for lunar — and borderline alignments that do not produce an eclipse are correctly rejected. The type is computed per event, not assigned from a list, which is exactly why the built-in validation tables can check it against NASA's catalog on any chart.
3. Placement
Eclipses land on calendar time, but markets don't trade every day. When an eclipse falls on a weekend, the marker is placed on the next trading session — never the prior bar — so the chart shows the first session that could react. 24/7 markets are automatically detected and retain the exact calendar date.
4. The Eclipse Moment Snapshot
Hover any marker for the full state of the sky at the eclipse: the eclipse type and precise date/time in your chosen timezone, Sun and Moon zodiac positions to the arc-minute, all eight planets with retrograde flags, both lunar nodes, and every active planetary aspect at that moment, sorted by tightest orb first.
█ FEATURES
Six Eclipse Types, Individually Colored
• Solar: Total (TSE), Annular (ASE), Partial (PSE)
• Lunar: Total (TLE), Partial (PLE), Penumbral (PENLE)
• Independent color control per type; solar and lunar layers toggle separately
Historical Markers
• Roughly 75 years of eclipse markers on daily charts, each with the full planetary tooltip
• Optional vertical eclipse lines through the chart
• Marker placement: above bar, below bar, chart top or bottom, or a fixed price level
Future Projections
• Forward scan up to two years ahead with the same refine-and-classify pipeline as historical detection
• Dashed projection lines with type-labeled markers and date labels
• Automatically clipped to TradingView's drawing horizon (500 bars past the last bar)
Planetary Relationships
• Every active aspect among the Sun, Moon, planets, and lunar nodes at the eclipse moment — conjunction, opposition, trine, square, sextile — is listed in the tooltip, with the tightest orb first
• Geocentric or heliocentric coordinate mode
Verification Built In
• Validation table, 2022–2025: 16 recent eclipses vs. NASA's catalog — expected vs. detected type and zodiac degree, pass/fail per row
• Historical validation table, 1901–1984: 16 eclipses from NASA's Five Millennium Catalog spanning all six types
• Both tables render live from the same code that detects your chart's eclipses — nothing is pre-recorded
Display & Alerts
• Timezone selection for all displayed times (exchange, UTC, or 11 major zones)
• Info table with layer status, look-ahead horizon, and live Sun–Moon separation
• Alert on every detected eclipse with type, zodiac position, date, and orb
█ HOW TO USE
1. Add the indicator to a Daily (1D) chart. Historical eclipse markers appear immediately; the tool is built for the daily timeframe and will tell you if the chart is set to anything else.
2. Hover any marker to read the eclipse moment snapshot — type, exact time, zodiac positions, retrogrades, nodes, and active aspects.
3. Check the future projections ahead of the current bar: dashed lines mark each upcoming eclipse with its type and date.
4. Choose your display timezone so eclipse times match your working clock.
5. To verify accuracy, enable the validation tables in Settings and compare the script's detections against NASA's catalog, row by row, on your own chart.
6. Enable alerts to be notified as each new eclipse is detected at its exact moment of closest approach.
7. Study how your market has behaved around past eclipses of each type — the per-type colors make it easy to separate total solar eclipses from penumbral lunars at a glance.
█ WHAT MAKES THIS ORIGINAL
Most eclipse indicators on TradingView are hardcoded date lists — a fixed table of events pasted into the code, valid only for the years the author transcribed, with no type information and nothing to verify. This detector computes eclipses from first principles, on the chart, from planetary positions.
Key contributions:
• Live astronomical detection — eclipses and their minute-level timing are computed from planetary positions on any symbol and any era, not transcribed from a catalog
• Per-event type classification — all six solar and lunar types determined computationally, with borderline non-eclipses correctly rejected
• Self-validating design — two built-in tables check the detector against 32 NASA-cataloged eclipses (1901–2025) using the same live code path, so accuracy is inspectable rather than claimed
• Trading-calendar placement — weekend eclipses land on the next trading session, with 24/7 markets auto-detected
• Complete eclipse-moment snapshot — every marker carries all planetary positions, retrogrades, nodes, and active aspects at the refined instant, not just a date stamp
█ LIMITATIONS & TIPS
• Daily (1D) charts only. Weekly and monthly bars sample the Moon's 29.5-day cycle too coarsely and would skip events, so the script gates itself to the daily timeframe.
• Historical markers use TradingView labels, which are capped at 500. On very long daily histories, this covers approximately the most recent 75 years. The validation tables go back further (to 1901) because they are computed, not drawn.
• Future projections extend to TradingView's drawing horizon of 500 bars past the last bar.
• Eclipse visibility is not modeled: this tool reports that an eclipse occurs and what type it is astronomically, not whether it is observable from a particular location.
• The eclipse markers are astronomical events, not signals. Whether and how a market responds to them is the study this tool exists to support.
• For mission-critical timing, cross-reference professional sources such as JPL Horizons, the Swiss Ephemeris, or NASA's eclipse catalog.
█ EPHEMERIS LIBRARY
The astronomical engine is the fully open-source Blueprint Ephemeris library, publicly available for study, modification, and reuse:
• BlueprintResearch/blueprint_ephemeris_lib — VSOP87D (planets), ELP2000-82 (Moon), Meeus (Pluto), validated against NASA JPL's DE440
█ CREDITS & REFERENCES
• Blueprint Ephemeris by BlueprintResearch — the open-source astronomical engine this detector is built on
• Validation targets drawn from NASA's eclipse catalog and Five Millennium Catalog of Solar Eclipses
█ ACCESS
This is an invite-only script. Access is provided through the Blueprint Research Paid Space on TradingView.
© 2026 Blueprint Research LLC · Hyperfork Matrix™
All indicators and Library MIT
All indicators and Library MIT
Pernyataan Penyangkalan
Informasi dan publikasi ini tidak dimaksudkan, dan bukan merupakan, saran atau rekomendasi keuangan, investasi, trading, atau jenis lainnya yang diberikan atau didukung oleh TradingView. Baca selengkapnya di Ketentuan Penggunaan.
© 2026 Blueprint Research LLC · Hyperfork Matrix™
All indicators and Library MIT
All indicators and Library MIT
Pernyataan Penyangkalan
Informasi dan publikasi ini tidak dimaksudkan, dan bukan merupakan, saran atau rekomendasi keuangan, investasi, trading, atau jenis lainnya yang diberikan atau didukung oleh TradingView. Baca selengkapnya di Ketentuan Penggunaan.