Pivot Chronicle
- Indicators
-
Aiireza Arjmandi Nezhad
I have been active in financial markets since 2015.
Over the years I have failed and won.
I have a channel on the TradingView site and I recently started my activity on the site - Version: 1.0
- Activations: 5
# PivotChronicle - Confirmed Swing Mapping for MetaTrader 5
A chart-based swing research indicator that tracks confirmed price pivots, distinguishes final and provisional swing nodes, and presents the current structure in a compact dashboard.
### A clearer record of market swings
PivotChronicle is a market-structure companion for MetaTrader 5. It identifies confirmed local highs and lows, organizes them into an alternating swing sequence, and shows which node is currently provisional and which nodes have become final.
The indicator is designed for traders and developers who want to inspect price structure without turning every chart mark into a trade recommendation.
### Core capabilities
- **Confirmed pivot detection** - configurable left-side and right-side bar requirements. A raw pivot is recorded only after the required right-side candles have closed.
- **Final and provisional swing states** - the latest alternating node remains provisional until an accepted opposite-side node appears. A more extreme or equal same-side pivot may replace that active node.
- **Context-aware history** - retains the minimum preceding pivot context needed to build the rolling display window consistently.
- **Swing sequence summary** - describes the latest three final highs and lows as rising, falling, mixed, or insufficient history.
- **Chart presentation** - optional raw pivot dots, swing arrows, H/L labels, confirmation labels, and a connected swing path.
- **Compact dashboard** - symbol, timeframe, pivot depth, history window, raw-pivot count, final/provisional counts, latest final highs/lows, active node, sequence summary, and alert-channel status.
- **Configurable notifications** - terminal popup, sound, MetaTrader mobile push, and terminal email.
- **Custom event output** - can emit chart events for a compatible, separately installed notification relay. This indicator does not send HTTP requests.
- **Developer data outputs** - six hidden buffers are available through `iCustom` / `CopyBuffer` for custom tools and research workflows.
### Inputs
**Swing Engine**
- Left Bars
- Right Bars
- Maximum Bars to Scan
- Minimum Swing Distance (points)
- Instance Tag
- Notify Catch-up Events
**Chart Display**
- Draw Raw Pivots
- Draw Swing Arrows
- Draw Swing Labels
- Draw ZigZag Path
- Arrow Offset
- Label Font Size
- High, Low, Provisional, Raw Pivot, and ZigZag Colors
**Dashboard**
- Show Dashboard
- Corner
- Horizontal and Vertical Offset
- Width
- Font Size
- Background, Accent, Text, and Muted Colors
**Alert Events**
- Final Swing High
- Final Swing Low
- Confirmed Raw High Pivot
- Confirmed Raw Low Pivot
- Provisional Node Revision
**Alert Channels**
- Popup
- Sound
- MetaTrader Mobile Push
- Email
- Optional custom chart events for a compatible external relay
### Understanding confirmation
A raw pivot and a final swing node are two different states:
1. A **raw pivot** is confirmed after the configured number of right-side candles have closed.
2. The latest accepted swing node is **provisional** while it is the last node in the alternating sequence. A later, accepted opposite-side node finalizes it.
3. A more extreme or equal same-side raw pivot can replace the current provisional node according to the indicator's documented tie policy.
This is a confirmation-based method, not a prediction of future turning points. Confirmation requires waiting for the selected right-side bars; the pivot is drawn at its formation candle after confirmation.
### Hidden data buffers
The indicator exposes six non-visual buffers:
| Buffer | Meaning |
|---:|---|
| 0 | Swing High price (final or provisional) |
| 1 | Swing Low price (final or provisional) |
| 2 | Raw High Pivot price inside the visible history window |
| 3 | Raw Low Pivot price inside the visible history window |
| 4 | Swing Status: `2` = final, `1` = provisional |
| 5 | Confirmation time for the corresponding swing node |
Values with no event are `EMPTY_VALUE`. Buffer indices and semantics are documented for custom `CopyBuffer` consumers.
### External notification relay
The indicator can emit a custom chart event for a compatible notification relay. This indicator package does not contain a Telegram bot client, does not make HTTP requests, and does not require a bot token. Relay software is separate and is not included in this Market product. A relay that uses HTTP requests must run as an Expert Advisor or script, not inside the indicator. Configure and test any external relay separately. Never share bot tokens or other credentials in screenshots, preset files, or public repositories.
### Important notes
- PivotChronicle is an analytical and research companion. It does not open trades, manage positions, recommend entries, or promise trading results.
- Confirmed raw pivots appear only after the configured right-side bars have closed. This deliberate delay is part of the method.
- The provisional swing node may be replaced by a later, more extreme or equal same-side pivot. Do not treat a provisional node as final.
- Market behavior, broker history, symbol digits, spread, and available chart history can affect the displayed structure.
- Test the indicator on a demo account and verify the selected settings before using it in a live analysis workflow.
- Popup, sound, push, and email delivery depend on the relevant MetaTrader terminal settings. External notification delivery requires a separately installed compatible relay.
## Suggested product tagline
**See the pivot. Track its confirmation. Understand the swing.**
