DocsChuyển từ TradingView

Chuyển từ TradingView

Một ứng dụng xây trên charting library của TradingView (Advanced Charts hoặc Trading Platform) hoặc trên Lightweight Charts chuyển sang TradeCanvas mà backend không phải thay đổi. Datafeed giữ nguyên, đặt sau một bridge. Các tên có thay đổi (tuỳ chọn, featureset, override, study, hình vẽ và phương thức) nằm trong các bảng mà MCP server dùng để trả lời, nên coding agent tra từng tên thay vì đoán. Trang này nêu những gì chuyển sang được, những gì thay đổi và những gì không chuyển sang được.

Giữ datafeed

feedFromJsApi chuyển một datafeed viết cho JS API (onReady, resolveSymbol, getBars, subscribeBars, và searchSymbols, getQuotes, subscribeQuotes nếu có) thành một DataFeed:

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

const feed = feedFromJsApi(datafeed)   // the app's datafeed, unchanged
await feed.ready()                      // onReady has answered: the timeframes it serves are known

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

Bridge làm những việc sau cho datafeed:

  • resolve mỗi mã một lần và truyền lại symbol info cho getBars và subscribeBars;
  • chuyển khung thời gian của biểu đồ thành resolution ('1h' → '60', '1d' → '1D'), và countBack, before của biểu đồ thành from, to và countBack tính bằng giây;
  • hỏi thêm một lần từ nextTime khi một khoảng thời gian không có nến;
  • unsubscribe bằng đúng guid đã dùng khi subscribe, và tải lại series khi datafeed gọi onResetCacheNeeded;
  • đọc pricescale và minmov của mã làm bước giá, session làm giờ giao dịch, và các khung thời gian datafeed phục vụ từ supported_resolutions.

Biểu đồ đọc các khung thời gian mà feed phục vụ lúc kết nối, và dựng các khung khác từ đó (biểu đồ 7 phút từ nến 1 phút). onReady trả lời sau, nên cần await feed.ready() trước khi tạo widget, hoặc tự truyền vào: feedFromJsApi(datafeed, { supportedTimeframes: ['1m', '1h', '1d'] }).

Server UDF

Server dùng giao thức UDF không cần viết code datafeed nào:

import { udfFeed } from '@tradecanvas/chart'

const feed = udfFeed({ url: 'https://data.example.com/udf', updateFrequency: 10_000 })
await feed.ready()   // the timeframes of its /config

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

Feed đọc /config, /symbols, /search, /history và /quotes. UDF không có push, nên nến và quote trực tiếp được hỏi lại sau mỗi updateFrequency ms (mặc định 10 s). headers được gửi kèm mọi request.

Để agent đối chiếu phần còn lại

MCP server có ba tool cho việc chuyển đổi:

ToolChức năng
migration_planCác bước theo thứ tự, những gì cần tìm trong code của ứng dụng, và tool nào đối chiếu kết quả của mỗi lần tìm.
migration_lookupMột tên chuyển thành gì: tuỳ chọn widget, featureset, override key, study, drawing shape, phương thức của widget hoặc chart, thành phần của datafeed hoặc broker, hoặc một resolution. Tool trả về tuỳ chọn, công tắc tính năng, style key, id chỉ báo (kèm giá trị mặc định và key của các đường), loại hình vẽ (kèm các điểm) hoặc lời gọi, và nói rõ khi không có gì tương đương và nên làm gì thay thế.
convert_widget_optionsToàn bộ object tuỳ chọn của new TradingView.widget({...}), gồm cả featureset và override, chuyển thành tuỳ chọn của ChartWidget; hoặc tuỳ chọn createChart của Lightweight Charts thành tuỳ chọn của Chart. Tool cũng liệt kê các lời gọi cần thực hiện sau khi biểu đồ được tạo và những gì không có chỗ tương ứng, rồi kiểm tra kết quả như validate_options.

Khi đã kết nối server, yêu cầu agent thực hiện việc chuyển đổi: agent gọi migration_plan trước rồi đi qua ứng dụng từ đó. Agent skill có cùng các bước cho agent không dùng server.

Những gì thay đổi

TradingViewTradeCanvas
new TradingView.widget({ container: 'id' }), library_pathnew ChartWidget(element, options); không cần host file nào
onChartReady(cb)Tuỳ chọn onReady, hoặc code đặt sau constructor
widget.activeChart().createStudy(...)widget.getChart().addIndicator(id, params); id ngắn: 'rsi', 'bb'
createShape({ time, price }, { shape }), thời gian tính bằng giâyaddDrawing({ type, anchors: [{ time, price }] }), thời gian tính bằng mili giây
Resolution: '60', '1D', 'W'Khung thời gian: '1h', '1d', '1w' (resolutionToTimeframe, timeframeToResolution)
disabled_features, enabled_featuresfeatures: mọi công tắc đều bật trừ khi đặt false
overrides, applyOverridesStyle key, trong chartOptions.overrides hoặc chart.applyOverrides(); kiểu đường viết bằng tên
save_load_adapterlayouts: { storage } với một LayoutStorage (list, load, save, remove)
Broker API, đường order và positionMột ExecutionAdapter, setOrders, setPositions và các event lệnh (Giao dịch)
Lightweight Charts: nến và marker tính bằng giâyMili giây: time * 1000

Những gì không chuyển sang được

  • Biểu đồ đã lưu. Layout, hình vẽ và study đã lưu theo định dạng của TradingView không tải được: người dùng tạo layout mới.
  • Chỉ báo tuỳ biến viết cho custom_indicators_getter phải viết lại thành một plugin chỉ báo, trừ khi một trong 134 chỉ báo có sẵn làm được việc tương tự.
  • Một số công cụ vẽ và featureset không có bản tương đương. migration_lookup cho biết đó là những cái nào, và nêu công cụ gần nhất.
  • Giao dịch trên nhiều mã. Order và position của một ExecutionAdapter là của mã đang hiển thị trên biểu đồ; phần quản lý tài khoản trên nhiều mã và nhiều tài khoản do ứng dụng tự làm.

Các bảng được viết từ tài liệu công khai của TradingView, đọc vào tháng 11 năm 2026, và được đối chiếu với tên của TradeCanvas ở mỗi lần build. Tên bị thiếu hoặc sai là một bug: báo lại trên GitHub.