Timed Swing Points [Free +] | cephxs

15 giờ trước

Timed Swing Points [Free +] | cephxs

This indicator is published under the Mozilla Public License 2.0. © cephxs, © fstarcapital

1. OVERVIEW

Timed Swing Points (TSP) highlights the timing of recent confirmed swing highs and lows and annotates them with context-aware time labels. Instead of drawing traditional pivot shapes and cluttering the chart, this streamlined free edition focuses on the temporal structure: WHEN pivots occur, not just WHERE. It helps discretionary traders quickly scan for clustering of swings around repeating intraday minutes or higher‑timeframe day names.

2. WHAT IT DOES

• Detects swing highs and lows using a sensitivity factor (len)
  
• Adds a time (or day name on daily timeframe) label at each qualified swing
  
• Optional filtering to only show labels during defined "key time" minute windows
  
• Automatically adapts label content to timeframe:
  Intraday: HH:MM (24h or 12h model depending future input extension)
  Daily: Full or abbreviated weekday names
  
• Respects a maximum number of displayed swing points to keep charts clean
  

3. CORE FEATURES

Swing Detection: Uses ta.pivothigh(len, len) / ta.pivotlow(len, len); a pivot is confirmed only after enough bars pass, avoiding repaint on the current bar.

Time Labeling: Places labels offset back to the pivot bar index (bar_index - len).

Key Time Filtering: When enabled, labels only show if the pivot's minute is inside one of three windows: 00–10, 24–36, 50–59 minutes. These windows target common liquidity / volatility phases.

Day Name Mode: On daily timeframe, labels display full (e.g., Monday) or abbreviated (e.g., Mon) day names depending on the Full Day Names setting.

Point Limiting: Oldest labels are removed once Maximum Points Displayed is exceeded.

Clean Visual Footprint: Shape markers and lines are disabled in this free build (internally set to constants). Focus remains on time annotation density rather than price level persistence.

4. INPUTS & PARAMETERS

• Sensitivity (len): Default 2. Swing pivot width. Higher = fewer, broader swings
  
• Maximum Points Displayed: Default 10. Caps number of recent swing labels retained
  
• Show Time Labels: Default true. Master toggle for all time labels
  
• Key Times Only: Default true. Restricts labels to predefined minute windows
  
• Prefix: Default blank. Optional text prepended to each label
  
• High Time Color: Default red. Text color for swing high labels
  
• Low Time Color: Default blue. Text color for swing low labels
  
• Text Size: Default Small. Controls label text size (Tiny → Huge)
  
• Full Day Names: Default true. Show full weekday names on daily timeframe
  

Internal Constants (Not User-Adjustable):

• Shape display flags (show_high, show_low) set false
  
• Line display and deletion logic present but disabled
  
• Timezone currently fixed to America/New_York in Automatic mode; DST handled by TradingView engine
  

5. HOW SWING TIME IS DETERMINED

1. For each bar the script evaluates pivot conditions
   
2. A pivot is confirmed only after the right width (len) bars complete—the label is then placed len bars back
   
3. Time extraction uses the pivot's bar timestamp and converts:
   Intraday: Formats HH:MM (24-hour). Infrastructure exists for future 12h toggle
   Daily: Converts timestamp to a weekday name
   
4. Key time filter checks the pivot's minute bucket. If outside defined windows and filter is active, the label is skipped
   

6. TIME WINDOWS LOGIC (KEY TIMES ONLY)

[code]
Minutes 00–10 → Opening sequence & initial liquidity sweep
Minutes 24–36 → Post initial rotation / mid-hour inflection zone
Minutes 50–59 → Pre hour close / micro-structure reshuffle
ICT Traders: View as macros and note when macros form swing points
[/code]

This pattern helps isolate intraday zones where structural shifts frequently occur, reducing noise from less consequential pivot timings.

7. USAGE GUIDELINES

• Start with Sensitivity = 2 or 3 for most liquid intraday symbols. Increase on higher timeframes to avoid excessive clustering
  
• Key Times Only ON: Ideal for focusing on session rotation pivots. OFF: Use for full discovery when studying custom time behaviors
  
• Combine with volume profile or divergence tools to qualify time-labeled swings (e.g., a swing forming at 09:30 NY vs. random mid-bar)
  
• Apply on lower timeframes (1–15m) to map recurring patterns or on Daily to see weekly rhythm changes
  

8. PERFORMANCE & LIMITATIONS

• Efficient: Only stores arrays of recent labels and prunes aggressively
  
• No Alerts: Current version does not fire alerts (Future Pro+ variant may include swing-time alerting)
  
• Timezone: Fixed to America/New_York
  

9. BEST PRACTICES

• Use a neutral chart theme; contrasting label colors amplify swing clusters
  
• When analyzing historical pattern reliability, temporarily raise Maximum Points Displayed to 50–100 then revert to lighter values for live trading
  
• Prefix field: Add a tag like "T:" if mixing multiple custom time tools to differentiate label origin
  

10. FAQ

Q: Why do some expected swings not show?
If they confirm outside key minute windows and filtering is ON, they're intentionally suppressed.

Q: Can I get price levels drawn?
Not in this free build. Lines/shapes are disabled intentionally.

Q: Does it repaint?
Pivot confirmation waits for the right width; labels appear only after the swing is locked in. Past labels aren't retroactively moved.

Q: Can I monitor multiple symbols at once?
This version is single‑symbol; use layouts or Pro variants for multi-source overlays.

11. CHANGELOG

v1.0 (Initial Free Release): Core swing time labeling, key time filter, day name adaptation, performance improvements. More updates coming.

12. DISCLAIMER

This tool is an analytical overlay designed for timing context only. It is NOT a standalone buy/sell signal. Always validate swings with broader market structure, liquidity pools, and risk management. No guarantee of future performance.

If you find this useful and want advanced variants (alerts, multi‑timezone, clustering metrics), reach out via TradingView. Feedback drives improvements.

8 giờ trước

Phát hành các Ghi chú

Bug Fixes