스톡 차트
시가-고가-저가-종가-거래량 캔들, 시장 시간 범위, 지표, 프로필, 가격 수준 및 마커.
프레임워크 빠른 시작
같은 주식 차트를 여섯 가지 방식으로 렌더링
명령형 TypeScript API 또는 얇은 프레임워크 어댑터를 선택하세요. 모든 탭은 같은 타입 배열 데이터와 차트 옵션을 사용합니다.@sixtyfold/stockimport { StockChart, type TimeRange } from "@sixtyfold/stock";
const data = {
timestamp: new Float64Array([0, 60_000, 120_000, 180_000]),
open: new Float64Array([100, 102, 101, 104]),
high: new Float64Array([103, 104, 105, 107]),
low: new Float64Array([99, 100, 100, 103]),
close: new Float64Array([102, 101, 104, 106]),
volume: new Float64Array([420, 510, 470, 630]),
length: 4,
};
const canvas = document.querySelector<HTMLCanvasElement>("#chart")!;
const chart = new StockChart(canvas, {
renderMode: "auto",
timeScale: "market",
showVolume: true,
priceUnit: { prefix: "$", decimals: 2 },
});
await chart.initialize();
chart.setData(data);
// The application owns the controls: choose any labels and ranges, or none.
const controls = document.querySelector("#stock-ranges")!;
for (const range of ["1D", "1M", "ALL"] as const satisfies readonly TimeRange[]) {
const button = document.createElement("button");
button.type = "button";
button.textContent = range;
button.addEventListener("click", () => chart.setTimeRange(range));
controls.append(button);
}
window.addEventListener("pagehide", () => chart.destroy(), { once: true });@sixtyfold/stock는 정렬된 시가, 고가, 저가, 종가 및 거래량(OHLCV) 열을 시장별 분석 레이어와 함께 렌더링합니다. 상세도(LOD) 프로세스는 많은 가시 캔들을 유효한 OHLCV 기간으로 자동 결합한 다음 줌 시 더 세분된 캔들로 되돌립니다.
정확한 구성 및 메서드 시그니처는 생성된 Stock options, StockChart methods 및 OHLCV data types 참조에 있습니다.
StockChart는 수명 주기, 뷰포트, 표시, 오버레이, 렌더러 및 배칭 메서드를 직접 노출합니다. 마켓타임 모드에서는 뷰포트 메서드가 압축된 관찰-세션 좌표를 보존하는 반면 공개 값은 실제 타임스탬프로 유지됩니다.
캔들 및 거래량
filled, hollow 또는 ohlc 캔들 기하를 선택하십시오. candleColors은 상승·하락 봉과 심지를 제어합니다. 거래량은 독립된 색상, 불투명도 및 패널 높이 비율을 가집니다.
렌더러 경계는 OHLCV 툴팁 및 크로스헤어 콜백의 표시 정밀도를 결정합니다. 애플리케이션이 명시적 통화, 단위, 소수점 또는 축약 형식을 요구하는 경우 priceUnit 및 volumeUnit을 제공하십시오.
호스트 소유 시간 범위
StockChart는 시간 범위 버튼을 생성하거나 스타일링하지 않습니다. 호스트 애플리케이션은 컨트롤의 레이블, 수, 순서, 레이아웃 및 접근성을 소유하거나 전혀 컨트롤을 렌더링하지 않을 수 있습니다.
버튼이 내보낸 편의 프리셋 중 하나에 매핑될 때 setTimeRange()를 호출하십시오: 1D, 5D, 1M, 3M, 6M, YTD, 1Y, 5Y 또는 ALL. 로드된 히스토리를 벗어나는 프리셋은 사용 가능한 데이터로 클램프됩니다.
const controls = document.querySelector<HTMLElement>("[data-stock-ranges]")!;
const ranges = [
["Day", "1D"],
["Six months", "6M"],
["Everything", "ALL"],
] as const;
for (const [label, range] of ranges) {
const button = document.createElement("button");
button.type = "button";
button.textContent = label;
button.dataset.range = range;
button.addEventListener("click", () => chart.setTimeRange(range));
controls.append(button);
}
canvas.addEventListener("sixtyfold:time-range-change", (event) => {
const detail = (event as CustomEvent).detail;
for (const button of controls.querySelectorAll("button")) {
button.setAttribute(
"aria-pressed",
String(button.dataset.range === detail.range),
);
}
});이름이 지정된 프리셋이 아닌 범위의 경우 일반 뷰포트 API를 통해 실제 타임스탬프를 전송하십시오:
const twoWeeks = 14 * 24 * 60 * 60_000;
let latestDataTimestamp = 0;
const chart = new StockChart(canvas, {
onVisibleRangeChange({ dataBounds }) {
latestDataTimestamp = dataBounds.xMax;
},
});
customButton.addEventListener("click", () => {
chart.setViewport({
xMin: latestDataTimestamp - twoWeeks,
xMax: latestDataTimestamp,
});
});market 시간-스케일 모드에서는 공개 뷰포트 값이 실제 타임스탬프로 유지되며 차트는 내부적으로 이를 압축된 관찰-세션 좌표로 변환합니다. 생성자 콜백은 onTimeRangeChange, onCrosshairMove 및 onVisibleRangeChange을 제공합니다. 동일한 상태 변경에 대해 네임스페이스된 DOM-이벤트 상수들이 내보내집니다.
지표
내장 지표는 원시 캔들에서 계산되며 렌더링 및 크로스헤어 값에 대해 활성 집계에 맞춰 샘플링됩니다.
chart.setIndicators([
{ type: "sma", id: "sma-20", period: 20, color: "#ffd166" },
{ type: "ema", id: "ema-50", period: 50, color: "#64d8ff" },
{ type: "bollinger", id: "bb-20", period: 20, deviation: 2 },
{ type: "vwap", id: "vwap-day", reset: "day" },
]);순수 함수들은 @sixtyfold/stock/analytics에서 제공됩니다: calculateSMA, calculateEMA, calculateBollingerBands, calculateVWAP 및 computeStockIndicator. 유한하지 않은 소스 값은 조용히 보간되는 대신 롤링 윈도우를 중단시킵니다.
시장 레이어
chart.setVolumeProfile({ rows: 48, placement: "right", valueAreaPercent: 70 });
chart.setPriceLines([
{ id: "entry", price: 182.4, label: "Entry", showAxisLabel: true },
]);
chart.setMarkers([
{ id: "earnings", timestamp, position: "above", shape: "diamond", label: "E" },
]);볼륨 프로필은 거래별 주문 흐름 재구성이 아닌 추정된 가격별 볼륨 히스토그램입니다. 표시된 가격 축을 행으로 나누고 각 OHLCV 캔들의 거래량을 해당 캔들이 보고한 저가‑고가 범위에 균등하게 분배합니다. 더 넓은 수평 막대는 특정 가격 주변의 더 많은 추정 볼륨을 나타냅니다. 상승(불리시)과 하락(베어리시) 부분은 캔들 방향을 사용하며, 컨트롤 포인트는 가장 큰 추정 볼륨을 가진 행을 표시하고 값 영역은 인접 행을 확장하여 구성된 표시 볼륨 비율을 포함할 때까지 확장됩니다.
프로필은 표시된 시간 및 가격 범위를 따릅니다. 긴 범위에서는 계산이 4,096개의 소스 캔들 이하가 되도록 유지하는 가장 세분화된 완성 캔들 집계를 사용하고, 확대된 범위에서는 원시 캔들을 사용합니다. 이는 상호작용의 범위를 제한하지만 두 경로 모두 OHLCV 데이터가 각 캔들 범위 내부에서 개별 거래가 발생한 위치를 보고하지 않으므로 캔들 기반의 근사치로 남습니다. 이 레이어를 정확한 가격별 체결, 푸트프린트 또는 주문 흐름 데이터로 설명하지 마십시오.
가격 라인은 데이터에 고정된 수평 레벨입니다. 마커는 타임스탬프순으로 정렬되고 표시 범위에 맞춰 제거되며; 캔들마다 하나의 마커를 사용하는 대신 간헐적 이벤트를 사용하십시오.
스트리밍
initialize() 이후, 양의 정수 용량으로 스트림을 생성하십시오:
chart.initStreaming(250_000);
chart.addCandle(timestamp, open, high, low, close, volume);스트리밍 타임스탬프는 유한하고 엄격히 증가해야 하며, 호출 간, 큐에 쌓인 스칼라 캔들, 청크 경계를 포함하여 일관되어야 합니다. 동일한 타임스탬프를 가진 append는 기존 캔들을 갱신하지 않으므로, 피드 중복을 먼저 제거하십시오.
열형 피드의 경우 여섯 개의 동일 크기 OHLCV 열을 가진 addCandles 또는 addCandleBatches을 사용하십시오. addCandleBatches는 어떤 전송도 수행하기 전에 전체 청크 목록을 검증합니다. 잘못된 타임스탬프 순서, 유한하지 않은 타임스탬프 또는 길이 불일치는 큐에 쌓인 캔들을 플러시하거나 호출자 버퍼를 분리하지 않고 거부됩니다. 유효한 스칼라 및 벌크 호출은 순서를 유지합니다. Worker 모드에서는 유효한 버퍼가 전송되므로, 추가하기 전에 애플리케이션에서 필요한 값을 캡처하십시오.
initialTimeRange은(는) 초기 전송 배치와 동일한 렌더러 턴에서 적용할 수 있어, 의도한 뷰포트가 나타나기 전에 전체 범위 프레임이 발생하는 것을 피합니다. 마켓 타임 뷰포트는 새로운 캔들이 추론된 케이던스를 변경하더라도 타임스탬프 고정점을 유지합니다.
정적 setData은(는) 다른 정렬 계약을 가집니다: 단조 증가 또는 감소하는 이력(동일 타임스탬프 포함)이 허용되며, 오름차순으로 정규화됩니다. 데이터 교체나 스트리밍 재설정은 보류 중인 샘플을 삭제하고 이전 데이터셋의 뷰포트 애니메이션을 취소합니다.
스트리밍 집계 계층은 오프스크린에서 스냅샷으로부터 재구성되어 활성 계층을 원자적으로 교체합니다. 완성된 레벨은 추가가 계속되는 동안에도 사용 가능하며, 차트는 부분적으로 구축된 대체물을 게시하지 않습니다.
CSV 로드
loadOHLCVFromCSV는 선택적 진행 콜백과 함께 브라우저 내 단순 데이터셋에 적합합니다. 매우 큰 Parquet 또는 독점 피드의 경우 UI 스레드 외부에서 디코딩하고 검증된 여섯 개의 타이프드 열을 직접 전송하십시오.