# Source provenance — cvELD TradingHolic 1.13.0

## Current release supersedes historical provider sections below

Yahoo price collection, full exchange-directory distribution/downloads and embedded news retrieval are disabled in 1.13.0. Local licensed history JSON and browser links replace those paths. See LICENSE_AUDIT.md. Historic development fixtures and full directories are not in the release ZIP.

本版ではYahoo自動取得・全銘柄ディレクトリー配布と取得・ニュース見出し取得を停止しました。以下の旧版の取得元説明は来歴の記録です。現行動作はLICENSE_AUDIT.mdを参照してください。

Cabinet Office holiday source: https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv . The data was processed into date-only application calendars and combined with local exchange-closure rules by cvELD; this processed version is not a government publication. Terms: https://www.cao.go.jp/notice/rule.html .
内閣府「国民の祝日について」のデータをcvELDが日付データへ加工し、市場休業日の計算と組み合わせています。内閣府作成の加工データではありません。

Astronomy Engine attribution/full MIT notice: LICENSES/AstronomyEngine-MIT.txt. GPL coverage of the app does not grant market-data or trademark permissions. TradingView, Blender, Yahoo, JPX and other names identify third-party services; no endorsement or affiliation is claimed.


## User-supplied Pine originals

These files are included byte-for-byte, without edits:

- `reference/APC-HL_v2.pine` — SHA-256 `27360681c26e119fccb2ab62adc15a279b7412cbf549406d6368a6417571402b`
- `reference/Mercury_JST.pine` — SHA-256 `4b031a70c08ff536b093e398bf47b3a22077be765ce6e1cbb7d0a00f6deeb3f8`

`technical.py` is a Python port of APC-HL v2's default drawing calculations:
automatic 350/500/600-bar windows, normal sensitivity, fast pivots of 5 bars,
ATR(14) Wilder smoothing, log-space channels, 64 recent pivots, up to 16 anchors,
0.5 ATR touch tolerance capped at 20% of width, 15% outside tolerance, both
directions, candidates, 60-bar reference fallback, six horizontal clusters and
the extrema-based L1/L2/H1/H2 context. Solid/dashed/dotted distinctions and
midlines/fills are retained. Quarter lines and round-number emphasis are off,
as in the supplied defaults. No Pine runtime or TradingView alert execution is
included. This is not a replacement line-fitting algorithm.

The rendered models refit from confirmed fetched bars. Source data, history
length, exchange symbols, minimum ticks and session boundaries can differ from
TradingView. For CME NIY the minimum tick is 5; other Yahoo instruments fall
back to the source price precision because an exchange minimum tick is not
provided. A live numerical equivalence comparison in Pine Editor has not been
performed. Public-feed history may include corrections; no non-repainting claim
is made.

`celestial.py` preserves the exact supplied Japanese-time Mercury date pairs and
the half-open overlap condition `time < end && time_close > start`, with a seven
day lead period. The source's large dashboard, market-fall wording, result
labels and alerts are replaced by compact calendar strips, as requested. The
table contains 1987 plus 2024–2026 periods only; it does not predict later dates.

## Lunar calendar

`data/moon_phases.json` covers 1980–2040 and is generated by the build-only
Astronomy Engine Python implementation by Don Cross, under the MIT License:
https://github.com/cosinekitty/astronomy

Build source SHA-256: `41248c7b1edbf9d11119528eef7455a6dc55abde9f1aab40d363015e956c1729`.
The unmodified build source, including the full MIT notice, is in
`tools/vendor/astronomy.py` in the development tree. It is not needed at runtime.
`tools/build_moon_calendar.py` reproduces the runtime table. All 2026 new/full
moon events were checked against USNO's public UTC phase data:
https://aa.usno.navy.mil/api/moon/phases/year?year=2026
Maximum difference was 78 seconds. Chart labels use JST; events during market
closures are placed between surrounding trading bars.

## Timeframes and data scope

Yahoo Finance provides 1m/5m/15m/30m/60m/daily/weekly/monthly data. Four-hour
candles are assembled from hourly OHLC with UTC buckets aligned to the source
hourly grid (:00 or :30), with no invented missing bars. This is different from
some exchange-session anchors used by TradingView. The latest 1,200 bars are
retained. Insufficient SMA warmup is shown as an ellipsis, not a partial-period
average.

TOPIX and Japanese mutual funds use public Yahoo Japan daily/weekly/monthly
history (up to approximately 400 bars); no intraday endpoint is available in
this adapter. Mutual-fund NAV has no actual OHLC and remains a clearly marked
line, with SMA if enough history exists. No fund candles are synthesized.

Session close handling uses provider metadata where available and ordinary
weekday close rules for Japanese history. Special holidays/short sessions that
are absent from source metadata may be treated conservatively until the period
boundary. This can delay the last model's confirmation relative to TradingView.


## Market clocks and SQ (1.3)

data/market_calendar.json records source URLs and its 2026-09-15 verification date.
JP holidays 2020–2027 use the Cabinet Office public holiday CSV plus exchange
closures January 2/3 and December 31, checked against JPX 2026–2027 calendars.
US holidays and 13:00 ET early closes for 2026–2028 use the NYSE official calendar.
Japan clock: TSE cash sessions, lunch break and closing auction. USA clock: NYSE
core session with post-2007 daylight-saving rules. Unknown years never claim open.
These are local calendar calculations, not real-time trading-status feeds.

Japanese monthly SQ uses the second Friday (preceding business day if closed),
with major SQ in March, June, September and December. Icons mark 09:00 JST,
the opening-price calculation start; the final SQ timestamp is not fixed.
SQ events are restricted to the bundled Japanese calendar years.

- https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv
- https://www.jpx.co.jp/corporate/about-jpx/calendar/index.html
- https://www.jpx.co.jp/equities/trading/domestic/01.html
- https://www.nyse.com/trade/hours-calendars
- https://www.jpx.co.jp/derivatives/products/domestic/225options/01.html

Starter symbols are representative familiar instruments, not a live market-cap
ranking. Nikkei futures are CME JPY futures (NIY=F); All Country is eMAXIS Slim NAV.


## Chart studies and drawings (1.4)

MACD uses SMA-seeded EMA12 minus EMA26, with EMA9 signal. RSI14 uses Wilder
smoothing. Regular divergence compares consecutive strict price pivots (five
closed bars on either side) and MACD at those pivots; coloring is retrospective
after confirmation. Price-volume profiles are approximations from visible OHLCV:
each bar's volume is distributed uniformly across intersected price bins.

Drawings store timestamps and prices. Freehand ink is a custom chart annotation
implementation, not a native Blender Grease Pencil object. New/full moon dates
remain from the bundled astronomical table; the crescent marker is a visual
approximation two days after each new moon. Calendar glyphs are original vectors.
Three original alert WAV assets are synthesized sine-wave bell/chime/pulse tones.
Alerts compare sampled quote prices, not tick-by-tick or exchange-triggered alerts.

References consulted:
- https://www.tradingview.com/support/solutions/43000502344-moving-average-convergence-divergence-macd-indicator/
- https://www.tradingview.com/support/solutions/43000502040-volume-profile-indicators-basic-concepts/
- https://docs.blender.org/api/5.2/bpy.types.Region.html
- https://github.com/blender/blender/blob/main/source/blender/makesrna/intern/rna_screen.cc


## Symbol directories and original interface (1.5)

Bundled data/symbols.json contains code/name/market facts retrieved 2026-09-15:
JPX TSE listed securities (4,434) and Nasdaq-traded US symbols (12,797), excluding
Nasdaq test issues and symbols without compatible code spelling. ETFs are included.
These data files do not imply that every security has an available price history.

- https://www.jpx.co.jp/markets/statistics-equities/misc/01.html
- https://www.jpx.co.jp/markets/statistics-equities/misc/tvdivq0000001vg2-att/data_j.xlsx
- https://nasdaqtrader.com/Trader.aspx?id=SymbolDirDefs
- https://www.nasdaqtrader.com/dynamic/SymDir/nasdaqtraded.txt

The six layout previews are original diagrams generated from the implemented cell
geometry by tools/build_layout_previews.py. Welcome thumbnails are original vector
diagrams. No TradingView UI images or source code are included. The custom NodeTree
host uses Blender's native registration API; no ToPu source code/assets were copied.

## Fear indices (1.7.0)
VIX prices use the existing Yahoo Finance provider; Cboe index definition: https://www.cboe.com/en/tradable-products/vix/ . Crypto Fear & Greed is daily Bitcoin-market sentiment from Alternative.me (https://alternative.me/crypto/fear-and-greed-index/), API https://api.alternative.me/fng/ . Alternative.me attribution is shown adjacent to the score/chart; insufficiently sized rows omit its data. No Fear & Greed history is bundled in the release ZIP.

## Price bands, workspace integration and headlines (1.9.0)
Original Python implementation of Donchian previous-bar ranges and Bollinger population-deviation bands:
- https://chartschool.stockcharts.com/table-of-contents/technical-indicators-and-overlays/technical-overlays/price-channels
- https://www.bollingerbands.com/bollinger-band-rules
SQ timing explanation follows JPX: https://www.jpx.co.jp/glossary/ta/326.html . Related news uses public Google News RSS search; publisher/source, publication time and article URL are displayed. No news headlines or article bodies are bundled in the release. Native workspace menu content is reused via Blender UILayout.menu_contents; no Blender startup settings are overwritten.

## cvELD QuietRange v2.0 (1.11.0)

User-provided `cvELD_QuietRange_TradingView_v6.txt` is preserved byte-for-byte as `reference/QuietRange_v2.pine`. SHA-256: `640b8385fe8a104d593f5e846515a1a62c80811a2fc0219cd984da4b9625108a`.

`quietrange.py` ports the full-range compression, eligible-bar history, display powers, prior-log distribution/median alerts, cooldown and response MA. `quietrange_layer.py` maps previous closed source bars, uses a separate visual scale, approximates JP/US intraday market edges, supports manual tick overrides and optional sampled-refresh audio. No TradingView/Pine runtime is embedded. Provider symbols, exchange feeds, minimum ticks and session flags can differ from TradingView. The original script and external project were not edited.