OKX에서 TradingView 차트를 활성화하는 방법

통합 아키텍처 개요

1. OKX는 공식 웹 인터페이스 내에서 TradingView 차트를 기본적으로 호스팅하지 않습니다. 대신, 사용자는 외부 임베딩이나 써드파티 통합을 통해 TradingView 에 접근합니다.

2. OKX 플랫폼은 맞춤형 TradingView Datafeed 구현에서 사용할 수 있는 REST 및 WebSocket API를 통해 실시간 시장 데이터를 제공합니다.

3. 개발자는 자신의 도메인이나 서브도메인에 TradingView 차팅 라이브러리를 배포한 다음 UDF 호환 데이터피드 레이어를 구성하여 OKX의 퍼블릭 엔드포인트를 연결해야 합니다.

4. 심볼 매핑에는 정규화가 필요합니다. OKX는 BTC-USDT-SWAP 와 같은 형식을 사용하는 반면 TradingView는 무기한 계약의 경우 OKX:BTCUSDT.P 또는 현물 쌍의 경우 OKX:BTCUSDT.SPOT 과 같은 식별자를 기대합니다.

5. 시간대 처리는 OKX의 서버 시간(UTC+0)과 일치해야 하며 /api/v5/market/candles 에서 반환된 캔들 타임스탬프는 시간대 오프셋 드리프트가 없는 Unix epoch 이후 밀리초로 변환되어야 합니다.

데이터피드 구현 요구 사항

1. /config 엔드포인트는 지원되는 간격, 지원되는 교환 및 기본 기호 유형을 반환해야 하며 모두 OKX의 사용 가능한 기기와 일치해야 합니다.

2. /symbols 엔드포인트는 OKX의 /api/v5/public/instruments 응답에 대해 유사 항목 검색을 수행하고 status=live 및 instType=SWAP/SPOT/MARGIN을 필터링합니다.

3. /history 엔드포인트는 TradingView의 바 요청(심볼, 해상도, from, to)을 OKX의 /api/v5/market/candles 에 매핑하여 올바른 리밋(콜당 최대 100바) 및 간격 변환(예: “15” → “15m”, “D” → “1D”)을 적용합니다.

4. 실시간 구독은 OKX의 WebSocket 채널 publicChannel:candle15m (또는 이와 동등한 것)에 의존하며, 여기서 각 메시지는 구문 분석되고 정규화되어 TradingView의 onRealtimeCallback 으로 푸시됩니다.

5. OKX 응답의 거래량 필드는 volCcy (호가 통화량) 및 vol (기본 통화량)을 사용합니다. TradingView는 기본 단위로 볼륨을 예상하므로 일관성을 위해 볼륨을 선택합니다.

기호 분해능 및 기기 매핑

1. 현물 거래 쌍에는 접미사 .SPOT 이 필요합니다. : BTC-USDT 는 OKX:BTCUSDT.SPOT 이 됩니다.

2. USDT 마진 영구 스왑은 .P : BTC-USDT-SWAP 가 OKX:BTCUSDT.P 로 매핑됩니다.

3. 코인 마진 계약에는 .C 가 추가됩니다. : BTC-USD-SWAP 는 OKX:BTCUSD.C 가 됩니다.

4. 각 확인된 기호에는 거래소별 세션 시간, 최소 틱 크기, 가격 규모 및 OKX의 TickSz 및 lotSz 필드에서 파생된 분수 자리가 포함되어야 합니다.

5. 마진 레벨, 펀딩 비율 및 미결제약정은 표준 TradingView 차트 렌더링에서 제외되지만 초기화 후 사용자 정의 JS 로직을 통해 위젯 오버레이에 주입될 수 있습니다.

인증 및 속도 제한 고려 사항

1. 공개 데이터 엔드포인트( /market/candles , /public/instruments )에는 API 키가 필요하지 않지만 엄격한 속도 제한(IP당 초당 20개 요청)을 적용합니다.

2. WebSocket 연결은 연결이 끊어지면 다시 연결해야 하며 OKX의 문서화된 시퀀스 번호 확인 및 하트비트 메커니즘을 사용하여 필요한 채널을 다시 구독해야 합니다.

3. 이미 가져온 시간 범위에 걸쳐 확대/축소 또는 패닝할 때 중복 HTTP 호출을 방지하려면 기록 막대의 클라이언트측 캐싱이 필수입니다.

4. TradingView의 getBars는 겹치는 시간 창을 요청할 수 있습니다. 중복 막대 삽입을 방지하려면 데이터피드에 중복 제거 논리를 구현해야 합니다.

5. 500001 (내부 오류), 51000 (비율 제한 초과) 및 58005 (수단을 찾을 수 없음)을 포함하여 OKX의 모든 오류 응답은 표준화된 TradingView 오류 코드로 변환되고 원시 OKX 오류 메시지를 최종 사용자에게 노출시키지 않고 기록되어야 합니다.

자주 묻는 질문

Q1: OKX의 공식 트레이딩 인터페이스에 TradingView를 직접 삽입할 수 있나요? 아니요. OKX는 프로덕션 UI에 타사 스크립트 삽입을 허용하지 않습니다. 모든 TradingView 통합은 독립형 대시보드나 OKX 페이지에 차트를 오버레이하는 브라우저 확장을 통해 OKX 도메인 외부에서 이루어져야 합니다.

Q2: OKX는 TradingView의 실시간 바에 대한 WebSocket 지원을 제공합니까? 예. OKX는 publicChannel:candle15m 과 같은 채널을 사용하여 WebSocket을 통한 캔들스틱 스트리밍을 지원합니다. 이를 통해 데이터피드가 메시지 순서 지정 및 간격 감지를 올바르게 처리하는 경우 폴링 없이 라이브 바 업데이트가 가능해집니다.

Q3: 올바른 매핑 후에도 일부 기호가 "데이터 없음"으로 나타나는 이유는 무엇입니까? 이는 계측기의 instState가 "live"가 아니거나 해당 계측기 유형에 대해 요청된 해상도가 지원되지 않을 때 발생합니다. 예를 들어 OKX는 영구 스왑을 위한 1초 캔들을 게시하지 않습니다.

Q4: TradingView 차트와 함께 OKX 오더북 깊이를 표시할 수 있습니까? 예. /api/v5/market/books 의 깊이 데이터는 D3.js 또는 경량 캔버스 라이브러리를 사용하여 별도로 렌더링한 다음 공유 타임스탬프 정렬 및 TradingView 컨테이너 요소에 대한 DOM 위치 지정을 통해 차트 타임프레임과 동기화할 수 있습니다.