Tiện ích và giới hạn

combine([x1, x2, …], (giaTri, i) => so) → chuỗi

🇻🇳 Tiếng Việt

combine

combine([x1, x2, …], (giaTri, i) => so) → chuỗi

Ghép nhiều chuỗi bằng một hàm JavaScript chạy ở từng nến: giaTri là mảng giá trị của các chuỗi ở nến đó, i là chỉ số nến. Hàm phải thuần (không nhớ gì giữa các nến). Hai chuỗi thì dùng gọn hơn a.zip(b, (x, y) => …); một chuỗi a.map((x, i) => …).

indicator({
  name: "Vị trí giá trong nến (combine)",
  plot: (d) => ({
    "Vị trí đóng cửa": columns(
      combine([d.open, d.high, d.low, d.close], ([o, h, l, c]) => (h > l ? (c - l) / (h - l) : 0.5)),
      { color: "accent" }
    ),
    "Giữa": hline(0.5),
  }),
});

Script có combine, map, zip chạy hơi chậm hơn script chỉ dùng phép có sẵn.

stats: thống kê trên mảng

Tính ngay trên một mảng số (không phải chuỗi) — dùng trong onBar với mảng tự giữ trong trạng thái, hoặc trong Quant AI Studio. NaN bị bỏ qua.

Hàm	Kết quả
stats.mean(a)	Trung bình
stats.std(a)	Độ lệch chuẩn mẫu
stats.variance(a)	Phương sai mẫu
stats.median(a)	Trung vị
stats.quantile(a, q)	Phân vị q (0–1)
stats.corr(a, b)	Hệ số tương quan (cần ≥ 3 cặp)
stats.linreg(x, y)	{ slope, intercept, r2 }
stats.tstat(a)	Thống kê t của trung bình
stats.sharpe(loiNhuan, soKyMoiNam = 250)	Sharpe quy năm
stats.maxDrawdown(giaTri)	Sụt giảm sâu nhất (số âm)
stats.drawdown(giaTri)	Mảng sụt giảm từ đỉnh tại từng điểm
stats.forward(giaTri, h)	Lợi nhuận h kỳ sau — chỉ để nghiên cứu, không dùng làm tín hiệu

dates: ngày

Ngày biểu diễn bằng số ngày kể từ 01/01/1970. Từ mốc thời gian (ms) của nến: Math.floor(ctx.time / 86400000).

Hàm	Kết quả
dates.parse("2025-03-10")	Số ngày (nhận cả "2025" = 01/01/2025)
dates.format(ngay)	"10/03/2025"
dates.iso(ngay)	"2025-03-10"
dates.year(ngay), dates.month(ngay), dates.day(ngay)	Năm, tháng (1–12), ngày
dates.weekday(ngay)	0 = Chủ nhật … 6 = thứ Bảy

indicator({
  name: "Thống kê trượt và ngày",
  pane: "price",
  state: () => ({ loiNhuan: [] }),
  onBar: (ctx, s) => {
    const truoc = ctx.bar(1).close;
    if (truoc > 0) s.loiNhuan.push(ctx.close / truoc - 1);
    if (s.loiNhuan.length > 60) s.loiNhuan.shift();
    const ngay = Math.floor(ctx.time / 86400000);
    if (dates.month(ngay) === 1 && dates.day(ngay) <= 7 && dates.weekday(ngay) === 1) {
      ctx.draw.label({ id: `nam-${dates.year(ngay)}`, at: { barsAgo: 0, price: ctx.high }, text: `${dates.year(ngay)}`, size: "s", color: "textMuted" });
    }
    if (s.loiNhuan.length < 60) return;
    return {
      sharpe: stats.sharpe(s.loiNhuan, 250),
      trungVi: stats.median(s.loiNhuan) * 100,
      p90: stats.quantile(s.loiNhuan, 0.9) * 100,
      lech: stats.std(s.loiNhuan) * 100,
    };
  },
  plot: (d, p, o) => ({
    "Sharpe 60 phiên": line(o.sharpe, { pane: "Sharpe", color: "accent" }),
    "Trung vị LN ngày %": line(o.trungVi, { pane: "Phân phối", color: "ref" }),
    "Phân vị 90 % LN ngày %": line(o.p90, { pane: "Phân phối", color: "up" }),
    "Độ lệch chuẩn %": line(o.lech, { pane: "Phân phối", color: "down" }),
  }),
});

log

log(...) (và console.log) ghi khi script dựng — hiện ở Nhật ký chạy của Quant AI Studio. Trên biểu đồ, thẻ Nhật ký hiện lỗi, những gì ghi bằng ctx.log(...) trong onBar (gắn với nến — onBar › ctx.log) và dòng console.log(...); log(...) không hiện ở đây.

JavaScript chuẩn

Dùng được: Math (Math.max, Math.min, Math.abs, Math.round, Math.floor, Math.sqrt, Math.log, Math.pow…), Number (Number.isNaN, Number.isFinite), mảng (push, shift, slice, map, filter, reduce, sort…), Object, JSON, chuỗi chữ, template …${x}…, for, while, if, switch, hàm, const / let.

Không có: import, mạng (fetch), lưu trữ trình duyệt, DOM, hẹn giờ (setTimeout), async trong indicator / strategy. Trong onBar và hàm tự viết, Math.random() cho cùng dãy số ở mọi lần chạy và Date.now() / new Date() là mốc của nến đang tính — để script luôn cho cùng kết quả.

Giới hạn

Giới hạn	Mức
Khai báo mỗi script	1 (indicator hoặc strategy)
Script gắn trên một biểu đồ	5
Đầu ra (plot)	64
Điều kiện cảnh báo (alerts)	32
Mã khác (d.symbol)	4
Nút tính của đồ thị	5.000
Đối tượng vẽ mỗi loại	mặc định 50, tối đa 500 (limits)
Bảng	9 vị trí, 100 ô mỗi bảng
Nhật ký	1.000 dòng gần nhất
ctx.track	500 nến mỗi khoá, tối đa 5.000 (limits.track)
Trạng thái onBar	256 KB
Thời gian tính toàn bộ lịch sử	2 giây
Thời gian mỗi lần cập nhật giá	50 ms (vượt nhiều lần liên tiếp: script tạm dừng, chỉ chạy lại khi có nến mới)
Thời gian biên dịch	3 giây

Vượt thời gian: Script chạy quá 2 giây khi tính toàn bộ lịch sử — đã dừng. Có thể do vòng lặp quá nặng hoặc vô hạn. — xem Hỏi đáp › hiệu năng.

Mã lỗi

Mỗi lỗi có một mã (hiện ở Nhật ký, Copilot đọc được). Lỗi thường gặp kèm cách sửa: Lỗi thường gặp.

Mã	Khi nào
syntax	Mã viết sai cú pháp JavaScript (thiếu ngoặc, dấu phẩy…)
runtime	Lỗi khi chạy: gọi tên không có, sai kiểu, lỗi trong onBar…
no-declaration, multiple-declarations	Không gọi / gọi nhiều lần indicator / strategy
lookahead	Đọc nến sau: shift(-1), ctx.bar(-1), ctx.prev(…, -1), ctx.track(…).at(-1)
universe-only	Phép chỉ có trong Studio (rank, topN…, d.meta)
eager-in-stream	Đọc giá trị ngay lúc dựng (.data, .last()…)
tf-lower, tf-misaligned	d.tf khung nhỏ hơn / không là bội số khung đang tính
ta-order	ctx.ta.* gọi khác thứ tự giữa các nến
state-not-json	Trạng thái chứa hàm / đối tượng không thuần
param	Đối số / tham số sai (fillna("0"), hline("70"), d.source("abc"), param.session("9-11")…)
import	Thư viện use(…): thiếu thư viện / phiên bản, khoá sai dạng, dùng vòng tròn, vượt 16 thư viện / 200.000 ký tự
limit	Vượt giới hạn (đầu ra, cảnh báo, mã khác, trạng thái)
budget-history, budget-tick	Vượt thời gian tính

🇬🇧 English

combine

combine([x1, x2, …], (giaTri, i) => so) → chuỗi

Combines several series with a JavaScript function that runs on each bar: giaTri is the array of the series' values on that bar, i is the bar index. The function must be pure (it remembers nothing between bars). For two series, a.zip(b, (x, y) => …) is shorter; for one series, a.map((x, i) => …).

indicator({
  name: "Vị trí giá trong nến (combine)",
  plot: (d) => ({
    "Vị trí đóng cửa": columns(
      combine([d.open, d.high, d.low, d.close], ([o, h, l, c]) => (h > l ? (c - l) / (h - l) : 0.5)),
      { color: "accent" }
    ),
    "Giữa": hline(0.5),
  }),
});

Scripts that use combine, map or zip run slightly slower than scripts that only use built-in operations.

stats: statistics on arrays

Computes immediately on an array of numbers (not a series) — use it in onBar with an array you keep in state, or in Quant AI Studio. NaN values are skipped.

Function	Result
stats.mean(a)	Mean
stats.std(a)	Sample standard deviation
stats.variance(a)	Sample variance
stats.median(a)	Median
stats.quantile(a, q)	Quantile q (0–1)
stats.corr(a, b)	Correlation coefficient (needs ≥ 3 pairs)
stats.linreg(x, y)	{ slope, intercept, r2 }
stats.tstat(a)	t-statistic of the mean
stats.sharpe(loiNhuan, soKyMoiNam = 250)	Annualized Sharpe
stats.maxDrawdown(giaTri)	Maximum drawdown (a negative number)
stats.drawdown(giaTri)	Array of drawdowns from the peak at each point
stats.forward(giaTri, h)	Return h periods ahead — for research only, do not use as a signal

dates: dates

A date is represented as the number of days since 01 Jan 1970. From a bar's timestamp (ms): Math.floor(ctx.time / 86400000).

Function	Result
dates.parse("2025-03-10")	Number of days (also accepts "2025" = 01 Jan 2025)
dates.format(ngay)	"10/03/2025"
dates.iso(ngay)	"2025-03-10"
dates.year(ngay), dates.month(ngay), dates.day(ngay)	Year, month (1–12), day
dates.weekday(ngay)	0 = Sunday … 6 = Saturday

indicator({
  name: "Thống kê trượt và ngày",
  pane: "price",
  state: () => ({ loiNhuan: [] }),
  onBar: (ctx, s) => {
    const truoc = ctx.bar(1).close;
    if (truoc > 0) s.loiNhuan.push(ctx.close / truoc - 1);
    if (s.loiNhuan.length > 60) s.loiNhuan.shift();
    const ngay = Math.floor(ctx.time / 86400000);
    if (dates.month(ngay) === 1 && dates.day(ngay) <= 7 && dates.weekday(ngay) === 1) {
      ctx.draw.label({ id: `nam-${dates.year(ngay)}`, at: { barsAgo: 0, price: ctx.high }, text: `${dates.year(ngay)}`, size: "s", color: "textMuted" });
    }
    if (s.loiNhuan.length < 60) return;
    return {
      sharpe: stats.sharpe(s.loiNhuan, 250),
      trungVi: stats.median(s.loiNhuan) * 100,
      p90: stats.quantile(s.loiNhuan, 0.9) * 100,
      lech: stats.std(s.loiNhuan) * 100,
    };
  },
  plot: (d, p, o) => ({
    "Sharpe 60 phiên": line(o.sharpe, { pane: "Sharpe", color: "accent" }),
    "Trung vị LN ngày %": line(o.trungVi, { pane: "Phân phối", color: "ref" }),
    "Phân vị 90 % LN ngày %": line(o.p90, { pane: "Phân phối", color: "up" }),
    "Độ lệch chuẩn %": line(o.lech, { pane: "Phân phối", color: "down" }),
  }),
});

log

log(...) (and console.log) writes while the script is being built — shown in the Nhật ký chạy (Run log) of Quant AI Studio. On the chart, the Nhật ký (Log) tab shows errors, whatever you write with ctx.log(...) in onBar (tied to a bar — onBar › ctx.log) and console.log(...) lines; log(...) does not appear there.

Standard JavaScript

Available: Math (Math.max, Math.min, Math.abs, Math.round, Math.floor, Math.sqrt, Math.log, Math.pow…), Number (Number.isNaN, Number.isFinite), arrays (push, shift, slice, map, filter, reduce, sort…), Object, JSON, string literals, template …${x}…, for, while, if, switch, functions, const / let.

Not available: import, network (fetch), browser storage, DOM, timers (setTimeout), async in indicator / strategy. In onBar and your own functions, Math.random() returns the same sequence on every run and Date.now() / new Date() is the timestamp of the bar being computed — so the script always gives the same result.

Limits

Limit	Value
Declarations per script	1 (indicator or strategy)
Scripts attached to one chart	5
Outputs (plot)	64
Alert conditions (alerts)	32
Other tickers (d.symbol)	4
Computation nodes in the graph	5,000
Drawing objects per type	50 by default, up to 500 (limits)
Tables	9 positions, 100 cells per table
Log	last 1,000 lines
ctx.track	500 bars per key, up to 5,000 (limits.track)
onBar state	256 KB
Time to compute the full history	2 seconds
Time per price update	50 ms (exceeded several times in a row: the script pauses and only runs again on a new bar)
Compile time	3 seconds

When time runs out: Script chạy quá 2 giây khi tính toàn bộ lịch sử — đã dừng. Có thể do vòng lặp quá nặng hoặc vô hạn. (The script ran for more than 2 seconds computing the full history and was stopped. A loop may be too heavy or infinite.) — see FAQ › performance.

Error codes

Each error has a code (shown in the Log, readable by Copilot). Common errors and how to fix them: Common errors.

Code	When
syntax	Invalid JavaScript syntax (missing bracket, comma…)
runtime	Error while running: calling a name that does not exist, wrong type, an error in onBar…
no-declaration, multiple-declarations	indicator / strategy not called / called more than once
lookahead	Reading a future bar: shift(-1), ctx.bar(-1), ctx.prev(…, -1), ctx.track(…).at(-1)
universe-only	An operation available only in Studio (rank, topN…, d.meta)
eager-in-stream	Reading a value at build time (.data, .last()…)
tf-lower, tf-misaligned	d.tf with a smaller timeframe / not a multiple of the current timeframe
ta-order	ctx.ta.* called in a different order between bars
state-not-json	State contains a function / an impure object
param	Wrong argument / parameter (fillna("0"), hline("70"), d.source("abc"), param.session("9-11")…)
import	use(…) libraries: missing library / version, malformed key, circular use, more than 16 libraries / 200,000 characters
limit	Limit exceeded (outputs, alerts, other tickers, state)
budget-history, budget-tick	Computation time exceeded

🇰🇷 한국어

combine

combine([x1, x2, …], (giaTri, i) => so) → chuỗi

각 봉에서 실행되는 JavaScript 함수로 여러 시리즈를 결합합니다. giaTri는 해당 봉에서 각 시리즈 값의 배열이고, i는 봉 인덱스입니다. 함수는 순수해야 합니다(봉 사이에 아무것도 기억하지 않음). 시리즈가 두 개라면 a.zip(b, (x, y) => …)가 더 간결하고, 하나라면 a.map((x, i) => …)를 사용합니다.

indicator({
  name: "Vị trí giá trong nến (combine)",
  plot: (d) => ({
    "Vị trí đóng cửa": columns(
      combine([d.open, d.high, d.low, d.close], ([o, h, l, c]) => (h > l ? (c - l) / (h - l) : 0.5)),
      { color: "accent" }
    ),
    "Giữa": hline(0.5),
  }),
});

combine, map, zip을 쓰는 스크립트는 내장 연산만 쓰는 스크립트보다 약간 느립니다.

stats: 배열 통계

숫자 배열(시리즈가 아님)에서 즉시 계산합니다. onBar에서 상태에 직접 보관한 배열과 함께 쓰거나 Quant AI Studio에서 사용합니다. NaN은 무시됩니다.

함수	결과
stats.mean(a)	평균
stats.std(a)	표본 표준편차
stats.variance(a)	표본 분산
stats.median(a)	중앙값
stats.quantile(a, q)	q 분위수(0–1)
stats.corr(a, b)	상관계수(쌍 3개 이상 필요)
stats.linreg(x, y)	{ slope, intercept, r2 }
stats.tstat(a)	평균의 t 통계량
stats.sharpe(loiNhuan, soKyMoiNam = 250)	연환산 샤프 지수
stats.maxDrawdown(giaTri)	최대 낙폭(음수)
stats.drawdown(giaTri)	각 지점에서 고점 대비 낙폭 배열
stats.forward(giaTri, h)	h 기간 후 수익률 — 연구용으로만 쓰고 신호로 쓰지 마세요

dates: 날짜

날짜는 1970년 1월 1일부터의 일수로 표현합니다. 봉의 타임스탬프(ms)에서 변환: Math.floor(ctx.time / 86400000).

함수	결과
dates.parse("2025-03-10")	일수("2025" = 2025년 1월 1일도 허용)
dates.format(ngay)	"10/03/2025"
dates.iso(ngay)	"2025-03-10"
dates.year(ngay), dates.month(ngay), dates.day(ngay)	연, 월(1–12), 일
dates.weekday(ngay)	0 = 일요일 … 6 = 토요일

indicator({
  name: "Thống kê trượt và ngày",
  pane: "price",
  state: () => ({ loiNhuan: [] }),
  onBar: (ctx, s) => {
    const truoc = ctx.bar(1).close;
    if (truoc > 0) s.loiNhuan.push(ctx.close / truoc - 1);
    if (s.loiNhuan.length > 60) s.loiNhuan.shift();
    const ngay = Math.floor(ctx.time / 86400000);
    if (dates.month(ngay) === 1 && dates.day(ngay) <= 7 && dates.weekday(ngay) === 1) {
      ctx.draw.label({ id: `nam-${dates.year(ngay)}`, at: { barsAgo: 0, price: ctx.high }, text: `${dates.year(ngay)}`, size: "s", color: "textMuted" });
    }
    if (s.loiNhuan.length < 60) return;
    return {
      sharpe: stats.sharpe(s.loiNhuan, 250),
      trungVi: stats.median(s.loiNhuan) * 100,
      p90: stats.quantile(s.loiNhuan, 0.9) * 100,
      lech: stats.std(s.loiNhuan) * 100,
    };
  },
  plot: (d, p, o) => ({
    "Sharpe 60 phiên": line(o.sharpe, { pane: "Sharpe", color: "accent" }),
    "Trung vị LN ngày %": line(o.trungVi, { pane: "Phân phối", color: "ref" }),
    "Phân vị 90 % LN ngày %": line(o.p90, { pane: "Phân phối", color: "up" }),
    "Độ lệch chuẩn %": line(o.lech, { pane: "Phân phối", color: "down" }),
  }),
});

log

log(...)(및 console.log)는 스크립트를 구성할 때 기록하며, Quant AI Studio의 Nhật ký chạy(실행 로그)에 표시됩니다. 차트에서는 Nhật ký(로그) 탭에 오류, **onBar 안의 ctx.log(...)**로 기록한 내용(봉에 연결 — onBar › ctx.log), console.log(...) 줄이 표시되며, log(...)는 여기에 표시되지 않습니다.

표준 JavaScript

사용 가능: Math(Math.max, Math.min, Math.abs, Math.round, Math.floor, Math.sqrt, Math.log, Math.pow…), Number(Number.isNaN, Number.isFinite), 배열(push, shift, slice, map, filter, reduce, sort…), Object, JSON, 문자열, 템플릿 …${x}…, for, while, if, switch, 함수, const / let.

사용 불가: import, 네트워크(fetch), 브라우저 저장소, DOM, 타이머(setTimeout), indicator / strategy 안의 async. onBar와 직접 작성한 함수에서 Math.random()은 실행할 때마다 같은 수열을 내고, Date.now() / new Date()는 계산 중인 봉의 시점입니다. 스크립트가 항상 같은 결과를 내도록 하기 위함입니다.

제한

제한	수준
스크립트당 선언	1(indicator 또는 strategy)
차트 하나에 붙일 수 있는 스크립트	5
출력(plot)	64
알림 조건(alerts)	32
다른 종목(d.symbol)	4
계산 그래프 노드	5,000
유형별 그리기 객체	기본 50, 최대 500(limits)
표	위치 9곳, 표당 셀 100개
로그	최근 1,000줄
ctx.track	키당 봉 500개, 최대 5,000(limits.track)
onBar 상태	256 KB
전체 이력 계산 시간	2초
가격 업데이트당 시간	50 ms(여러 번 연속 초과 시 스크립트가 일시 중지되고 새 봉이 생길 때만 다시 실행)
컴파일 시간	3초

시간 초과: Script chạy quá 2 giây khi tính toàn bộ lịch sử — đã dừng. Có thể do vòng lặp quá nặng hoặc vô hạn.(전체 이력 계산 중 스크립트가 2초를 넘어 중지됨. 반복문이 너무 무겁거나 무한 루프일 수 있음) — FAQ › 성능을 참고하세요.

오류 코드

각 오류에는 코드가 있습니다(로그에 표시되며 Copilot이 읽을 수 있음). 자주 발생하는 오류와 해결 방법: 자주 발생하는 오류.

코드	발생 시점
syntax	JavaScript 구문 오류(괄호, 쉼표 누락…)
runtime	실행 중 오류: 없는 이름 호출, 잘못된 타입, onBar 내부 오류…
no-declaration, multiple-declarations	indicator / strategy를 호출하지 않음 / 여러 번 호출
lookahead	이후 봉 읽기: shift(-1), ctx.bar(-1), ctx.prev(…, -1), ctx.track(…).at(-1)
universe-only	Studio에만 있는 연산(rank, topN…, d.meta)
eager-in-stream	구성 시점에 값을 즉시 읽음(.data, .last()…)
tf-lower, tf-misaligned	d.tf의 시간 단위가 계산 중인 시간 단위보다 작음 / 배수가 아님
ta-order	봉마다 ctx.ta.* 호출 순서가 다름
state-not-json	상태에 함수 / 순수하지 않은 객체가 포함됨
param	잘못된 인수 / 매개변수(fillna("0"), hline("70"), d.source("abc"), param.session("9-11")…)
import	use(…) 라이브러리: 라이브러리 / 버전 누락, 잘못된 키 형식, 순환 사용, 라이브러리 16개 / 200,000자 초과
limit	제한 초과(출력, 알림, 다른 종목, 상태)
budget-history, budget-tick	계산 시간 초과

🇨🇳 中文

combine

combine([x1, x2, …], (giaTri, i) => so) → chuỗi

用一个在每根 K 线上运行的 JavaScript 函数合并多个序列：giaTri 是各序列在该 K 线上的值组成的数组，i 是 K 线索引。函数必须是纯函数（不在 K 线之间保存任何东西）。两个序列时用 a.zip(b, (x, y) => …) 更简洁；一个序列用 a.map((x, i) => …)。

indicator({
  name: "Vị trí giá trong nến (combine)",
  plot: (d) => ({
    "Vị trí đóng cửa": columns(
      combine([d.open, d.high, d.low, d.close], ([o, h, l, c]) => (h > l ? (c - l) / (h - l) : 0.5)),
      { color: "accent" }
    ),
    "Giữa": hline(0.5),
  }),
});

含有 combine、map、zip 的脚本比只使用内置运算的脚本稍慢。

stats：数组统计

在一个数字数组（不是序列）上立即计算——用于 onBar 中自行保存在状态里的数组，或在 Quant AI Studio 中使用。NaN 会被忽略。

函数	结果
stats.mean(a)	平均值
stats.std(a)	样本标准差
stats.variance(a)	样本方差
stats.median(a)	中位数
stats.quantile(a, q)	q 分位数（0–1）
stats.corr(a, b)	相关系数（需要 ≥ 3 对）
stats.linreg(x, y)	{ slope, intercept, r2 }
stats.tstat(a)	均值的 t 统计量
stats.sharpe(loiNhuan, soKyMoiNam = 250)	年化 Sharpe
stats.maxDrawdown(giaTri)	最大回撤（负数）
stats.drawdown(giaTri)	每个点相对高点的回撤数组
stats.forward(giaTri, h)	h 期后的收益——仅用于研究，不能用作信号

dates：日期

日期用自 1970年1月1日 起的天数表示。从 K 线的时间戳（毫秒）换算：Math.floor(ctx.time / 86400000)。

函数	结果
dates.parse("2025-03-10")	天数（也接受 "2025" = 2025年1月1日）
dates.format(ngay)	"10/03/2025"
dates.iso(ngay)	"2025-03-10"
dates.year(ngay)、dates.month(ngay)、dates.day(ngay)	年、月（1–12）、日
dates.weekday(ngay)	0 = 星期日 … 6 = 星期六

indicator({
  name: "Thống kê trượt và ngày",
  pane: "price",
  state: () => ({ loiNhuan: [] }),
  onBar: (ctx, s) => {
    const truoc = ctx.bar(1).close;
    if (truoc > 0) s.loiNhuan.push(ctx.close / truoc - 1);
    if (s.loiNhuan.length > 60) s.loiNhuan.shift();
    const ngay = Math.floor(ctx.time / 86400000);
    if (dates.month(ngay) === 1 && dates.day(ngay) <= 7 && dates.weekday(ngay) === 1) {
      ctx.draw.label({ id: `nam-${dates.year(ngay)}`, at: { barsAgo: 0, price: ctx.high }, text: `${dates.year(ngay)}`, size: "s", color: "textMuted" });
    }
    if (s.loiNhuan.length < 60) return;
    return {
      sharpe: stats.sharpe(s.loiNhuan, 250),
      trungVi: stats.median(s.loiNhuan) * 100,
      p90: stats.quantile(s.loiNhuan, 0.9) * 100,
      lech: stats.std(s.loiNhuan) * 100,
    };
  },
  plot: (d, p, o) => ({
    "Sharpe 60 phiên": line(o.sharpe, { pane: "Sharpe", color: "accent" }),
    "Trung vị LN ngày %": line(o.trungVi, { pane: "Phân phối", color: "ref" }),
    "Phân vị 90 % LN ngày %": line(o.p90, { pane: "Phân phối", color: "up" }),
    "Độ lệch chuẩn %": line(o.lech, { pane: "Phân phối", color: "down" }),
  }),
});

log

log(...)（以及 console.log）在脚本构建时写入——显示在 Quant AI Studio 的Nhật ký chạy（运行日志）中。在图表上，Nhật ký（日志）标签页显示错误、在 onBar 中用 ctx.log(...) 写入的内容（与 K 线关联——onBar › ctx.log）以及 console.log(...) 行；log(...) 不会显示在这里。

标准 JavaScript

可以使用：Math（Math.max、Math.min、Math.abs、Math.round、Math.floor、Math.sqrt、Math.log、Math.pow…）、Number（Number.isNaN、Number.isFinite）、数组（push、shift、slice、map、filter、reduce、sort…）、Object、JSON、字符串、模板字符串 …${x}…、for、while、if、switch、函数、const / let。

不可使用：import、网络（fetch）、浏览器存储、DOM、定时器（setTimeout）、indicator / strategy 中的 async。在 onBar 和自写函数中，Math.random() 每次运行都给出相同的数列，Date.now() / new Date() 是当前计算 K 线的时间点——以确保脚本始终得到相同结果。

限制

限制项	上限
每个脚本的声明	1 个（indicator 或 strategy）
一个图表上挂载的脚本	5
输出（plot）	64
提醒条件（alerts）	32
其他代码（d.symbol）	4
计算图节点	5,000
每类绘图对象	默认 50，最多 500（limits）
表格	9 个位置，每个表格 100 个单元格
日志	最近 1,000 行
ctx.track	每个键 500 根 K 线，最多 5,000（limits.track）
onBar 状态	256 KB
计算全部历史的时间	2 秒
每次价格更新的时间	50 ms（连续多次超时：脚本暂停，只在有新 K 线时重新运行）
编译时间	3 秒

超时提示：Script chạy quá 2 giây khi tính toàn bộ lịch sử — đã dừng. Có thể do vòng lặp quá nặng hoặc vô hạn.（脚本计算全部历史超过 2 秒——已停止。可能是循环过重或无限循环。）——见常见问题 › 性能。

错误代码

每个错误都有一个代码（显示在日志中，Copilot 可读取）。常见错误及修复方法：常见错误。

代码	何时出现
syntax	代码 JavaScript 语法错误（缺括号、逗号…）
runtime	运行时错误：调用不存在的名称、类型错误、onBar 中出错…
no-declaration、multiple-declarations	未调用 / 多次调用 indicator / strategy
lookahead	读取后面的 K 线：shift(-1)、ctx.bar(-1)、ctx.prev(…, -1)、ctx.track(…).at(-1)
universe-only	仅 Studio 可用的运算（rank、topN…、d.meta）
eager-in-stream	在构建时立即读取值（.data、.last()…）
tf-lower、tf-misaligned	d.tf 的周期小于当前计算周期 / 不是其整数倍
ta-order	ctx.ta.* 在不同 K 线间的调用顺序不同
state-not-json	状态中包含函数 / 非纯对象
param	参数错误（fillna("0")、hline("70")、d.source("abc")、param.session("9-11")…）
import	use(…) 库：缺少库 / 版本、键格式错误、循环引用、超过 16 个库 / 200,000 个字符
limit	超出限制（输出、提醒、其他代码、状态）
budget-history、budget-tick	超出计算时间