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_lookup | 1 つの名前が何になるか:ウィジェットのオプション、featureset、override のキー、study、描画の shape、 ウィジェットやチャートのメソッド、データフィードや broker のメンバー、または resolution。対応するオプション、 機能スイッチ、スタイルキー、インジケーター id(既定値とラインのキー付き)、描画タイプ(その点付き)、または 呼び出しを返し、相当するものがないときはそう明言して、代わりにどうするかを示します。 |
convert_widget_options | new TradingView.widget({...}) のオプションオブジェクト全体を、featureset と override も含めて ChartWidget のオプションに変えます。Lightweight Charts の createChart のオプションなら Chart のオプションに変えます。チャートができたあとに行う呼び出しと、置き場所のないものも挙げ、
結果を validate_options と同じように検査します。 |
サーバーをつないだら、エージェントに移行を頼んでください。最初に migration_plan を呼び、そこからアプリを
順に進めます。サーバーのないエージェント向けには、エージェントスキルに同じ手順があります。
変わるもの
| TradingView | TradeCanvas |
|---|---|
new TradingView.widget({ container: 'id' })、library_path | new 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_features | features:false にしない限り、どのスイッチもオン |
overrides、applyOverrides | スタイルキー。chartOptions.overrides か chart.applyOverrides() で指定し、線のスタイルは名前で書く |
save_load_adapter | layouts: { 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 で報告してください。