ドキュメントTradingView からの移行

TradingView からの移行

TradingView のチャーティングライブラリ(Advanced Charts または Trading Platform)や Lightweight Charts で作った アプリは、バックエンドを変えずに TradeCanvas に移せます。データフィードはそのままで、ブリッジの後ろに置きます。 変わる名前、つまりオプション、featureset、override、study、描画、メソッドは、 MCP サーバーが答えるための対応表にまとめてあるので、 コーディングエージェントは推測せずに 1 つずつ調べます。このページでは、引き継げるもの、変わるもの、引き継げないものを説明します。

データフィードはそのまま

feedFromJsApi は、JS API 向けに書かれたデータフィード(onReady、 resolveSymbol、getBars、subscribeBars、あれば searchSymbols、 getQuotes、subscribeQuotes)を DataFeed に変えます。

import { feedFromJsApi } from '@tradecanvas/chart'
import { ChartWidget } from '@tradecanvas/chart/widget'

const feed = feedFromJsApi(datafeed)   // アプリのデータフィードをそのまま
await feed.ready()                      // onReady が答えた:提供する時間足がわかっている

const widget = new ChartWidget(document.getElementById('chart'), { feed, symbol: 'AAPL', timeframe: '1d' })

ブリッジがデータフィードのために行うこと:

  • 銘柄ごとに 1 回だけ resolve し、その symbol info を getBars と subscribeBars に渡し返す。
  • チャートの時間足を resolution に変え('1h' → '60'、'1d' → '1D')、チャートの countBack と before を秒単位の from、 to、countBack に変える。
  • ある範囲にバーがなかったとき、nextTime からもう 1 回求める。
  • 購読したときの guid で購読を解除し、データフィードが onResetCacheNeeded を呼んだらシリーズを読み込み直す。
  • 銘柄の pricescale と minmov を呼値の刻み、session を取引時間として読み、 提供する時間足を supported_resolutions から読む。

チャートはフィードにつないだときにそのフィードが提供する時間足を読み、ほかの時間足はそこから作ります(1 分足のバーから 7 分足のチャートを作るなど)。onReady が答えるのはそのあとなので、ChartWidget を作る前に feed.ready() を await するか、時間足を自分で渡します: feedFromJsApi(datafeed, { supportedTimeframes: ['1m', '1h', '1d'] })。

UDF サーバー

UDF を話すサーバーなら、データフィードのコードはまったく要りません。

import { udfFeed } from '@tradecanvas/chart'

const feed = udfFeed({ url: 'https://data.example.com/udf', updateFrequency: 10_000 })
await feed.ready()   // /config にある時間足

new ChartWidget(el, { feed, symbol: 'AAPL', timeframe: '1d' })

/config、/symbols、/search、/history、 /quotes を読みます。UDF にはプッシュがないので、ライブのバーと気配値は updateFrequency ミリ秒ごと(既定は 10 秒)に求め直します。headers はすべてのリクエストに付けて送ります。

残りの対応付けはエージェントに

MCP サーバーには移行用のツールが 3 つあります。

ツールすること
migration_plan順番どおりの手順、アプリのコードで何を検索するか、そして検索で見つかったものをどのツールで対応付けるか。
migration_lookup1 つの名前が何になるか:ウィジェットのオプション、featureset、override のキー、study、描画の shape、 ウィジェットやチャートのメソッド、データフィードや broker のメンバー、または resolution。対応するオプション、 機能スイッチ、スタイルキー、インジケーター id(既定値とラインのキー付き)、描画タイプ(その点付き)、または 呼び出しを返し、相当するものがないときはそう明言して、代わりにどうするかを示します。
convert_widget_optionsnew TradingView.widget({...}) のオプションオブジェクト全体を、featureset と override も含めて ChartWidget のオプションに変えます。Lightweight Charts の createChart のオプションなら Chart のオプションに変えます。チャートができたあとに行う呼び出しと、置き場所のないものも挙げ、 結果を validate_options と同じように検査します。

サーバーをつないだら、エージェントに移行を頼んでください。最初に migration_plan を呼び、そこからアプリを 順に進めます。サーバーのないエージェント向けには、エージェントスキルに同じ手順があります。

変わるもの

TradingViewTradeCanvas
new TradingView.widget({ container: 'id' })、library_pathnew ChartWidget(element, options)。ホストするものはない
onChartReady(cb)onReady オプション、またはコンストラクターのあとのコード
widget.activeChart().createStudy(...)widget.getChart().addIndicator(id, params)。id は短い:'rsi'、'bb'
createShape({ time, price }, { shape })、時刻は秒addDrawing({ type, anchors: [{ time, price }] })、時刻はミリ秒
resolution:'60'、'1D'、'W'時間足:'1h'、'1d'、'1w'(resolutionToTimeframe、timeframeToResolution)
disabled_features、enabled_featuresfeatures:false にしない限り、どのスイッチもオン
overrides、applyOverridesスタイルキー。chartOptions.overrides か chart.applyOverrides() で指定し、線のスタイルは名前で書く
save_load_adapterlayouts: { storage } と LayoutStorage(list、load、save、remove)
Broker API、注文ラインとポジションラインExecutionAdapter、setOrders、setPositions と注文のイベント(取引)
Lightweight Charts:バーとマーカーの時刻は秒ミリ秒:time * 1000

引き継げないもの

  • 保存したチャート。TradingView の形式で保存したレイアウト、描画、study は読み込めません。 ユーザーは新しいレイアウトから始めます。
  • custom_indicators_getter 向けに書いたカスタムインジケーターは、 インジケータープラグインとして書き直します。134 個の組み込みインジケーターに 同じことをするものがあれば、それを使います。
  • 一部の描画ツールと featureset には相当するものがありません。どれがそうかは migration_lookup が答え、いちばん近いツールを挙げます。
  • 複数銘柄にまたがる取引。ExecutionAdapter の注文とポジションはチャートの銘柄のものです。 多くの銘柄と口座にまたがる口座管理はアプリ側で持ちます。

対応表は TradingView の公開ドキュメント(2026 年 11 月に参照)をもとに書かれ、ビルドのたびに TradeCanvas 自身の名前と 照合されます。足りない名前や誤った名前はバグです。GitHub で報告してください。