cvELD Trading Holic / GUIDE
WORKFLOW GUIDE / 1.15.0

制作の横に、チャートを。

一覧を眺める、チャートを調べる、モデリングしながら表示する。最初のチャートから各機能の操作までをご案内します。

Blender 4.5 LTS / 5.x8言語のUI価格履歴JSONを読み込み
このマニュアルの内容
01

最初のチャートを表示

まずは架空データで試せます。銘柄を登録しただけでは価格は取得されません。

このツールはBlender内で価格履歴を眺めるチャートボードです。売買注文は行いません。配布ZIPを「プリファレンス → エクステンションを入手 → ディスクからインストール」で選び、有効にします。Blender 4.5 LTS / 5系用の共通ZIPです。

エディター種類から cvELD Trading Holic、または3Dビューの Trading Holic メニューから開きます。Nパネル名は cvELD Trading Holic。開始画面の案内からボードやチャートへ進めます。

まず「一覧編集 → JSON読み込み」で examples/watchlist.json を追加し、「価格履歴JSONを読み込む」で examples/synthetic_history.json を読み込み、DEMOを選びます。これは架空の価格です。自分の銘柄には利用権のある履歴JSONが必要です。

最初のチャートを表示
Blender 4.5.8 · 実画面/架空データ

更新・アンインストール

更新前に銘柄リストを書き出してください。完全なバックアップにはCONFIG/cvELD_TradingHolic内のwatchlist.jsonとwatchlist_quotes.jsonを両方保存します。更新ZIPをインストールし、有効にします。削除する場合はプリファレンスのアドオン/エクステンション一覧で無効化してアンインストールします。バックアップは別途保管してください。

02

価格データと対応範囲

株・指数・為替・暗号資産の価格はローカルOHLCV JSONから読み込みます。銘柄コードを登録しただけでは価格は届きません。Yahoo価格の自動取得、全上場銘柄一覧の取得、組み込みニュース見出し取得は停止しています。楽天ランキングの自動取得は未搭載です。

「更新」や自動更新の設定があっても、株価のライブ配信を意味しません。オンライン取得は出典を併記したAlternative.meの暗号資産Fear & Greedのみです。VIXは利用権のあるローカル履歴が必要。既存の価格キャッシュは保存しますが、古い価格や取得失敗の表示を確認してください。

寄り付き・休場・SQなどは同梱カレンダーによる計算です。臨時休場、売買停止、証券会社との接続状態は監視しません。

03

一覧・チャート・同時表示

「一覧ボード」は登録順を使い、画面に収まるだけタイルを並べます。「全タブ」は指数・為替・株・米株・暗号資産の先頭、2番目…を交互に表示。ホイールで残りへ進みます。初期登録は各10銘柄、計50銘柄。人気ランキングの自動更新ではありません。

「チャート」は選択銘柄を大きく表示。「一覧+チャート」は最大8枚のカードと詳細チャート。カードを押しても同じモード内でチャートが切り替わります。各ビューは銘柄・時間足・表示モード・指標設定を独立して保持します。

短いビューでは上部ボタンを「表示」「操作」にまとめます。銘柄名・価格・インジケーター一覧はチャート上に重ねます。終了は「閉じる」またはEsc。元のエディターへ戻ります。

一覧ボード:グループを切り替えて銘柄を比較。
一覧ボード:グループを切り替えて銘柄を比較。 提供スクリーンショット(英語UI)。価格・欠損・警告表示は撮影時点の状態です。
一覧+チャート:上のカードと詳細チャートを同じペインに表示。
一覧+チャート:上のカードと詳細チャートを同じペインに表示。 提供スクリーンショット(英語UI)。価格・欠損・警告表示は撮影時点の状態です。
04

名前・コードとJSON

「名前またはコード」に7203、Toyota、ビットコイン、BTC-USDなどを入力。表示名は任意。複数候補は検索から選びます。検索対象は初期選定銘柄と登録済み銘柄で、全銘柄検索サービスではありません。「一覧編集」で順番・分類・追加・削除を変更。最大100銘柄です。

「JSON書き出し」は全5分類のコード・表示名・順番を保存します。価格履歴・個人設定は含みません。「JSON読み込み」は新規追加または一覧をすべて置換。形式不正・重複・上限超過は変更前に拒否します。チャートの手描き線は保持します。

手動バックアップはBlenderのCONFIG/cvELD_TradingHolic内のwatchlist.jsonとwatchlist_quotes.jsonを両方保存してください。Blender 4.5と5系の設定フォルダーは別になるため、リストの移行にはJSON書き出し/読み込みを使えます。

名前・コードとJSON
Blender 4.5.8 · 実画面/架空データ
05

価格履歴JSONの書式

トップレベルはformat: cvELD.TradingHolic.history、version: 1、quotes配列。各履歴はcode、timeframe、barsを指定します。各足のtはUnix秒、o/h/l/cは始値・高値・安値・終値、vは出来高またはnull。任意のendは終了Unix秒、closedは確定状態です。name、currency、source、mintickも指定可能です。

時刻は昇順、価格は正の有限値、出来高は非負またはnull。1履歴2〜1200本、最大100履歴・16 MB。取り込み成功後に指標を再計算し、条件が有効なら通知判定を行います。足が足りない指標は表示できません。

時間足は1m / 5m / 15m / 30m / 1h / 4h / 1d / 1wk / 1mo。切り替え先の履歴が必要です。分足データがないのに日足から架空の分足を作る機能ではありません。

06

移動・拡縮・A/L・時計

チャート上をドラッグすると上下左右へ移動。ホイールで表示期間を調整します。右端の価格軸を上下ドラッグして縦倍率、下の日付軸を横ドラッグして横倍率を調整します。最後の足の右側にも余白を取れます。

右下のAは表示範囲に価格を自動フィット、Lは対数表示。価格軸の操作はAutoを解除します。軸のダブルクリックでリセット。ドラッグ途中のEscはその操作を取り消します。オシレーターの横方向は価格チャートと連動、縦方向は段ごとに独立です。

時計をクリックしてJP/USを切り替え、取引時間を確認します。ザラ場は明るく、時間外は薄く表示。日本は東証現物の09:00–11:30、12:30–15:30 JST。米国は通常09:30–16:00 ET。先物・FX・暗号資産の営業時間を示すものではありません。

移動・拡縮・A/L・時計
Blender 4.5.8 · 実画面/架空データ
07

テクニカル一覧と基本指標

銘柄下の「テクニカル」を展開。目でOn/Off、名前または設定アイコンで調整します。リスト上のホイールと▲▼で項目を送ります。表示切り替えと開閉状態はペイン別です。

SMAは20/50/200、24/120/200、24/168、現物株20/50/200の4プリセット。長期ほど太い線。G/Dをクリックすると交差した本数と意味を確認できます。APC-HLは自動水平線・上昇/下降の平行チャネルを個別に表示可能。Pine原本からPythonへ移植した計算です。

価格バンドはドンチャン(初期値20本、現在足を除く高値・安値)とボリンジャー(初期値SMA20本±母標準偏差2倍)を切り替えます。本数や濃さなどを設定できます。

MACDは12/26/9、RSIは14本を初期値とします。MACDの?ヒントで現在の状態やダイバージェンス検出を確認。検出には後続足による確認が必要な場合があり、売買の予測を保証しません。出来高は時間別/価格帯別を選択。価格帯別はOHLCVからの近似で、約定ごとの正確な出来高分布ではありません。

テクニカル一覧と基本指標
Blender 4.5.8 · 実画面/架空データ
08

cvELD QuietRange

値幅の圧縮を反応の山として価格チャートの背面に表示します。初期計算は有効な6本の平均値幅の逆数の4乗。赤は確定、緑は未確定の反応です。上下の方向を予測する指標ではありません。価格軸のAuto範囲には影響しません。

設定は計算/対象/表示/通知。本数、値幅の下限、ティック補正、出来高加重、市場除外、感度、濃さ・高さ、反応MA、色、印を調整。音声通知は初期OFF。開始・収束の新たな確定を価格更新時に評価します。初回は過去通知を鳴らしません。

計算時間足は同じか上位。他銘柄・上位足は対象の1本前の確定足を参照。必要な銘柄・時間足の履歴を先に読み込んでください。下位足はエラー。ティック推定・市場時間の近似など、元Pineの配信元固有の状態とは差が生じます。

09

指標の配置・カレンダー

MACD・RSI・時間別出来高・恐怖指数は、重ね表示/段分け/段番号を個別指定から選べます。同じ番号は同じ段。各指標は独自のスケール。高さ・濃さを調整できます。恐怖指数はVIXと暗号資産Fear & Greedの切り替え式です。F&Gは日次値で、出典を表示できない狭さでは値を省略します。

満月・新月・三日月、水星逆行、SQ/MSQを表示できます。カレンダー設定で月相・水星・SQそれぞれの表示先を価格チャートまたはオシレーターへ変更。オシレーターがなければ価格側へ表示します。

SQ/MSQアイコンをクリックすると日付と09:00 JSTからの算出開始の説明を表示。SQ値の確定時間を予告する機能ではありません。ニュースはブラウザーで関連検索を開き、見出しを自動取得しません。市場カレンダーの同梱範囲は日本2020–2027年、米国2026–2028年。範囲外や未取得データは不明として扱います。月相・水星の印は売買効果を保証しません。

10

チャートへの描画と通知

描画メニューにペン・水平線・トレンド線・平行線を用意しています。ペンはチャート専用の描画で、BlenderのGrease Pencilオブジェクトではありません。座標は日時と価格に結びつくため、チャートの拡縮・移動に追従します。

線を右クリックして設定を開き、色・太さ・延長・接触通知・許容幅を設定。音はBell / Chime / Pulseの3種類。通知は取り込まれた価格更新時の判定で、常時リアルタイム監視ではありません。

Ctrl+Zで描画を戻し、Ctrl+Shift+ZまたはCtrl+Yでやり直し。メニューからも可能。履歴はペイン別50操作、再読み込みまで。「このチャートの描画を一括削除」は現在の銘柄・ペインだけが対象で、Undoできます。移動操作へ戻るには「チャートを移動」。

チャートへの描画と通知
Blender 4.5.8 · 実画面/架空データ
11

モデリング中の背景チャート

3DビューのTrading Holicメニュー、またはNパネルの背景チャートからOn/Off。1〜4銘柄を配置し、タイル・行・列・フォーカスなどを選べます。各コードの選択ボタンで登録銘柄から指定できます。

横・縦位置、幅・高さ、スケール、透明度、表示本数、テクニカル表示を調整します。背景は閲覧専用で、モデリング操作を受け取ります。背景内の複数チャートはそのビューの指標設定を共用します。

標準のビュー情報・統計との重なりを避けるのは文字だけです。追加の上余白設定で文字を下へ移動できます。他アドオンの独自文字は自動検出しません。色補正はシーンの露出を変更しません。ワークスペースの+ → Trading Holicで複数の画面をまとめた構成も作れます。

Trading Holicメニューから背景チャート、ワークスペース、設定パネルを開閉。
Trading Holicメニューから背景チャート、ワークスペース、設定パネルを開閉。 提供スクリーンショット(英語UI)。価格・欠損・警告表示は撮影時点の状態です。
12

表示言語を切り替える

Blenderのプリファレンス → インターフェイス → 翻訳で言語を選び、インターフェイスを有効にします。8言語:英語、日本語、中国語(簡体字・繁体字)、韓国語、スペイン語、ドイツ語、フランス語、ブラジルポルトガル語。中国語の字体違いを含めて9ロケールです。

1.15.0から通常のパネルと独自描画のチャート・背景チャートが同じ言語設定に従います。ツールチップの翻訳は別の設定です。translations/translation.csvで訳文を編集し、アドオンを再有効化すると反映します。登録銘柄のコード・ユーザーの表示名は変更しません。マニュアルと動画は別資料です。

言語設定に連動するチャート画面
Blender 5.2.1 · 実画面/架空データ
13

困ったとき・検証範囲

価格が空欄:銘柄コードと時間足の一致、履歴JSONの取り込み結果を確認。更新失敗:価格横の!へマウスを重ねます。日付が古い:キャッシュです。コード登録や更新ボタンだけで新しい株価にはなりません。

小さく読めない:文字サイズ補正は−4〜+24。必要な指標だけ表示し、段分け・透明度を調整。時間足変更で空になる場合はその時間足の履歴を追加してください。

4.5対応版は4.5.8 LTSで登録・解除・再登録、エクステンションZIP、実際のGPU描画を検証。5.2.1でもパッケージ登録と描画を確認済みです。4.5.0の登録検証も通過しました。物理マウス操作の全組み合わせや全OSを保証する検証ではありません。撮影は隔離したシーンと架空データを使用し、既存の作業シーンは変更しません。

14

ライセンスと収録物

コードはGPL-3.0-or-later。LICENSE・SOURCE_NOTICES・LICENSE_AUDITを参照。市場データの利用権はコードのライセンスとは別です。Blender、TradingView、証券会社・取引所との提携や承認はありません。

1.14.0はBlender 4.5 LTS対応、現行マニュアル、プロモーション画像5枚、解説動画を追加。1.13.2の省スペース配置、1.13.1の背景色補正、1.13.0のJSON入出力・取得制限を維持。過去の取得機能の説明を現行仕様と混同しないでください。

60秒プロモーション

英語ナレーション。新規バナーと提供スクリーンショットによる60秒の紹介動画です。

Japanese subtitles (SRT) · English subtitles (SRT)

WORKFLOW GUIDE / 1.15.0

Keep your charts close to your craft.

Scan your watchlist, explore a chart, or keep prices in the background while modeling. Start here, then explore each feature.

Blender 4.5 LTS / 5.x8 UI languagesBring your history JSON
In this guide
01

Your first chart

Try the bundled synthetic data first. Adding a symbol alone does not retrieve its prices.

This add-on displays price histories inside Blender; it does not place trades. Install the release ZIP using Preferences → Get Extensions → Install from Disk, then enable it. The same ZIP supports Blender 4.5 LTS and Blender 5.x.

Choose cvELD Trading Holic from the editor selector, or open it through Trading Holic in a 3D View header. The sidebar category is cvELD Trading Holic. The welcome screen provides routes to the board and charts.

For a first result, add examples/watchlist.json using Edit watchlist → Import JSON, then use Import price history JSON for examples/synthetic_history.json. Select DEMO. These are invented prices; your own symbols require history data you have rights to use.

Your first chart
English-localized image edit of a Blender 4.5.8 capture. Illustrative UI; synthetic data.

Updating and uninstalling

Export your watchlist before updating. For a full backup, keep watchlist.json and watchlist_quotes.json from CONFIG/cvELD_TradingHolic together. Install and enable the updated ZIP. To uninstall, disable and remove the extension in Blender Preferences. Keep your backup separately.

02

Price data and availability

Import local OHLCV JSON for stocks, indices, FX and crypto. Registering a symbol does not download its prices. Yahoo price collection, complete exchange-directory downloads and embedded news headlines are disabled. Automated Rakuten turnover rankings are not implemented.

Update and automatic-refresh controls do not imply a live stock-price feed. The only enabled online data source is attributed Alternative.me crypto Fear & Greed. VIX requires licensed local history. Existing caches are retained; check timestamps and stale/error indicators.

Market clocks and SQ use bundled calendars. They do not monitor emergency closures, trading halts or brokerage connection status.

03

Board, chart and combined mode

Board fills available space with registered tiles. All groups interleaves each group's first entry, then its second, and so on. Scroll for remaining entries. Starters contain ten symbols in each of five groups, fifty total; this is not an automatically ranked universe.

Chart enlarges the selected instrument. Board + Chart combines up to eight cards with a detail chart; card selection updates that chart without leaving the mode. Each editor pane retains its own symbol, timeframe, display mode and indicator settings.

Short views condense the toolbar into View / Actions. Symbol, price and indicator controls overlay the chart to save height. Close or Esc restores the previous editor.

Board: switch groups to compare symbols.
Board: switch groups to compare symbols. User-provided screenshot, English UI. Prices, missing data and warnings reflect the captured state.
Board + Chart: watchlist cards and the detailed chart share one pane.
Board + Chart: watchlist cards and the detailed chart share one pane. User-provided screenshot, English UI. Prices, missing data and warnings reflect the captured state.
04

Names, codes and JSON

Enter a code or name such as 7203, Toyota, Bitcoin or BTC-USD. A display label is optional. Use search for ambiguous matches. Search covers selected starters and registered symbols, not every listed security. Edit watchlist controls order, groups, additions and removal, up to 100 entries.

Export JSON saves codes, labels and order for all groups, excluding price history and personal settings. Import JSON adds new entries or replaces the entire list. Invalid formats, duplicates and over-limit files are rejected before changes. Chart ink is preserved.

For a full manual backup keep both watchlist.json and watchlist_quotes.json in Blender's CONFIG/cvELD_TradingHolic directory. Blender 4.5 and 5.x use separate settings directories; portable JSON transfers watchlists between them.

Names, codes and JSON
English-localized image edit of a Blender 4.5.8 capture. Illustrative UI; synthetic data.
05

History JSON format

Top-level fields are format: cvELD.TradingHolic.history, version: 1 and a quotes array. Each history has code, timeframe and bars. A bar contains Unix-seconds t, positive o/h/l/c (open/high/low/close), and volume v or null. Optional end is the closing Unix time; closed indicates confirmation. Name, currency, source and mintick are optional.

Times must increase; prices must be finite and positive; volume must be nonnegative or null. Limits are 2–1200 bars per history, 100 histories and 16 MB. Successful imports recompute indicators and evaluate enabled alerts. Indicators needing more bars remain unavailable.

Timeframes are 1m / 5m / 15m / 30m / 1h / 4h / 1d / 1wk / 1mo. Supply history for the selected timeframe. Daily bars are not turned into invented minute candles.

06

Navigation, A/L and clocks

Drag inside a chart to pan horizontally and vertically. The wheel changes the visible period. Drag the right price axis vertically to scale prices; drag the bottom date axis horizontally to scale time. Space can be left after the final candle.

A fits prices to the visible range; L selects logarithmic display. Price-axis manipulation disables Auto. Double-click axes to reset; Esc cancels an active drag. Oscillators share the horizontal timeline while retaining separate vertical scales.

Click the clock to switch JP/US and inspect session hours. Open sessions are bright, closed sessions dim. TSE cash sessions are 09:00–11:30 and 12:30–15:30 JST; NYSE core hours are normally 09:30–16:00 ET. These are not futures, FX or crypto opening indicators.

Navigation, A/L and clocks
English-localized image edit of a Blender 4.5.8 capture. Illustrative UI; synthetic data.
07

Indicator list and studies

Expand Indicators below the symbol. The eye toggles visibility; the name or settings icon opens adjustments. Scroll over the list or use ▲▼. Expansion and visibility are per pane.

SMA presets are 20/50/200, 24/120/200, 24/168 and cash-equity 20/50/200. Longer averages are thicker. Click G/D for the crossed periods and explanation. APC-HL provides independently toggled horizontal levels and rising/falling parallel channels. Its supplied Pine source is ported to Python.

Switch price bands between Donchian (20 preceding highs/lows, excluding the current bar) and Bollinger (20-bar SMA ±2 population standard deviations). Periods and opacity are configurable.

MACD defaults to 12/26/9; RSI to 14 bars. MACD ? hints describe state and detected divergence. Some detections require later bars for confirmation and do not guarantee future price direction. Volume can be shown by time or price; the price profile approximates OHLCV distribution and is not tick-level traded volume.

Indicator list and studies
English-localized image edit of a Blender 4.5.8 capture. Illustrative UI; synthetic data.
08

cvELD QuietRange

QuietRange draws range-compression response peaks behind price candles. Defaults raise the inverse six-eligible-bar mean range to power four. Closed responses are red; developing responses green. It does not predict direction and does not alter price-axis Auto fitting.

Calculation / Source / Display / Alerts configure lengths, range floor, tick correction, volume weighting, session exclusions, gain, opacity, height, response MA, colors and markers. Sound alerts default OFF. New confirmed onset/settled events are checked on price updates; initialization does not replay historical alerts.

Source timeframes must match or exceed the chart. Other-symbol or higher-timeframe calculations reference the preceding confirmed source bar. Import the required histories first. Lower timeframes are rejected. Estimated tick sizes and approximate sessions can differ from feed-specific Pine states.

09

Study arrangement and calendar

MACD, RSI, time volume and fear can overlay together, use separate rows or share manually assigned row numbers. Each uses its own scale; height and opacity are adjustable. Fear switches between VIX and crypto Fear & Greed. F&G is daily; values are omitted when its adjacent attribution cannot fit.

Full/new/crescent moon, Mercury retrograde and SQ/MSQ markers can be shown. Calendar settings independently place moon, Mercury and SQ on the price chart or oscillator area; without an oscillator they fall back to price.

Click SQ/MSQ for date and the 09:00 JST calculation-start explanation. This does not predict final SQ publication time. News opens a related browser search instead of fetching headlines. Bundled market-calendar coverage is Japan 2020–2027 and USA 2026–2028; unsupported dates or missing data remain unknown. Celestial markers make no claim of trading effectiveness.

10

Chart ink and alerts

Drawing offers pen, horizontal, trend and parallel lines. Pen strokes are chart-specific ink, not Blender Grease Pencil objects. Points use time/price coordinates and follow zooming and panning.

Right-click a line for color, width, extension, touch alerts and tolerance. Choose Bell / Chime / Pulse. Alerts evaluate incoming price updates; this is not continuous real-time monitoring.

Ctrl+Z undoes ink; Ctrl+Shift+Z or Ctrl+Y redoes it. Menu actions are also available. History is per pane, fifty operations until reload. Clear drawings in this chart affects only the current symbol/pane and is undoable. Return to Pan chart for navigation.

Chart ink and alerts
English-localized image edit of a Blender 4.5.8 capture. Illustrative UI; synthetic data.
11

Background charts while modeling

Toggle background charts from the 3D View Trading Holic menu or sidebar. Display one to four symbols using tile, row, column or focus arrangements. Picker buttons select registered symbols.

Adjust horizontal/vertical position, width/height, scale, opacity, visible bars and technical visibility. Background charts are read-only and leave modeling interaction available. Charts within one background view share that view's study settings.

Only chart text moves to avoid Blender's standard view information/statistics. Extra top spacing moves it further; custom text from other add-ons cannot be detected automatically. Color handling does not change scene exposure. Workspace + → Trading Holic also creates a multi-editor arrangement.

Use the Trading Holic menu to toggle backgrounds or open the workspace and sidebar.
Use the Trading Holic menu to toggle backgrounds or open the workspace and sidebar. User-provided screenshot, English UI. Prices, missing data and warnings reflect the captured state.
12

Change the UI language

Select a language in Blender Preferences → Interface → Translation and enable Interface. Eight languages: English, Japanese, Chinese (Simplified/Traditional), Korean, Spanish, German, French and Brazilian Portuguese, in nine locale variants.

Since 1.15.0, native panels, custom charts and background charts follow the same interface language. Tooltips use a separate Blender option. Edit translations/translation.csv and reload the add-on to apply changes. Symbol codes and user names are preserved. Manuals and videos are separate materials.

Chart UI following the selected language
Blender 5.2.1 · Actual UI / synthetic data
13

Troubleshooting and validation

Blank prices: check the symbol, timeframe and history-import result. Hover ! beside the price for errors. Old timestamps indicate cached data. Registering a code or clicking Update does not supply fresh stock prices.

Small text: adjust Font size offset from −4 to +24, hide unnecessary studies and adjust rows/opacity. If switching timeframes empties the chart, import that timeframe's history.

Compatibility validation targets Blender 4.5.8 LTS registration/unregistration/re-registration, the extension ZIP and actual GPU drawing, plus package registration and drawing on 5.2.1. This does not establish every physical input combination or every OS. Captures use an isolated scene and invented data, preserving the user's working scene.

14

License and included materials

Code is GPL-3.0-or-later. See LICENSE, SOURCE_NOTICES and LICENSE_AUDIT. Market-data rights are separate from the code license. No affiliation or endorsement by Blender, TradingView, brokers or exchanges is claimed.

Version 1.14.0 adds Blender 4.5 LTS support, current documentation, five promotional images and a tutorial. It retains 1.13.2 compact layout, 1.13.1 background-color correction and 1.13.0 JSON exchange/data restrictions. Historical descriptions of collection features do not describe the current release.

60-second overview

English narration. A 60-second overview using new artwork and user-provided screenshots.

Japanese subtitles (SRT) · English subtitles (SRT)