문서TradingView에서 옮겨오기

TradingView에서 옮겨 오기

TradingView 차팅 라이브러리(Advanced Charts 또는 Trading Platform)나 Lightweight Charts로 만든 앱은 백엔드를 바꾸지 않고 TradeCanvas로 옮길 수 있습니다. 데이터피드는 그대로 두고 브리지 뒤에 둡니다. 바뀌는 이름, 즉 옵션, featureset, override, study, 그리기, 메서드는 MCP 서버가 답할 때 쓰는 대응표에 들어 있어서, 코딩 에이전트는 짐작하지 않고 하나씩 찾아봅니다. 이 페이지는 그대로 이어지는 것, 바뀌는 것, 옮겨 오지 못하는 것을 설명합니다.

데이터피드는 그대로

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' })

브리지가 데이터피드를 위해 하는 일:

  • 종목마다 한 번만 resolve하고, 그 symbol info를 getBars와 subscribeBars에 다시 넘깁니다.
  • 차트의 시간 단위를 resolution으로 바꾸고('1h' → '60', '1d' → '1D'), 차트의 countBack과 before를 초 단위의 from, to, countBack으로 바꿉니다.
  • 어떤 구간에 봉이 없으면 nextTime부터 한 번 더 요청합니다.
  • 구독할 때 쓴 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 ms마다 (기본 10초) 다시 요청합니다. headers는 모든 요청에 함께 보냅니다.

나머지 대응은 에이전트에게

MCP 서버에는 옮겨 오기용 도구가 세 개 있습니다.

도구하는 일
migration_plan순서대로 된 단계, 앱 코드에서 무엇을 검색할지, 그리고 검색에서 찾은 것을 어느 도구로 대응시킬지.
migration_lookup이름 하나가 무엇이 되는지: 위젯 옵션, 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에 알려 주세요.