Lập trình FireAnt Script
- 🇻🇳 Tiếng Việt
- 🇬🇧 English
- 🇰🇷 한국어
- 🇨🇳 中文
Chương này dạy bạn tự viết chỉ báo và chiến lược cho FireAnt Chart bằng FireAnt Script — kể cả khi bạn chưa từng lập trình. Bạn sẽ bắt đầu bằng một đường trung bình ba dòng, rồi đi dần tới chỉ báo có trạng thái, đối tượng vẽ, cảnh báo, chiến lược có dừng lỗ và cách kiểm thử sao cho kết quả đáng tin.
Mọi đoạn mã trong chương đều chạy được: bạn sao chép (nút ⧉ ở góc khối mã), dán vào trình soạn script rồi bấm Thêm vào biểu đồ. Các đoạn mã này được kiểm tự động trên chính bộ chạy script của FireAnt Terminal mỗi khi tài liệu thay đổi.
Chương này nói về ngôn ngữ. Các nút, thẻ và bảng của khung script (thư viện, lưu, tham số, kiểm thử, nhật ký, cảnh báo, lọc mã) được tả ở trang FireAnt Script — nên đọc lướt trang đó trước.
Bạn làm được gì với FireAnt Script
| Bạn muốn | Ví dụ | Học ở |
|---|---|---|
| Vẽ đường của riêng bạn lên giá | EMA 20 tô xanh khi giá trên đường, đỏ khi dưới | Bài 1 |
| Chỉ báo ở ngăn riêng có vùng | RSI có vùng quá mua / quá bán tô màu | Bài 2 |
| Đánh dấu tín hiệu | Mũi tên khi MACD cắt lên, tô nền phiên khối lượng đột biến, tô màu n ến | Bài 3 |
| Cho người dùng chỉnh số | Chu kỳ, ngưỡng, loại đường trung bình chọn trong danh sách | Bài 4 |
| Nhận thông báo | Báo khi RSI cắt lên 30 — trên máy chủ FireAnt, cả khi bạn đóng biểu đồ | Bài 5 |
| Đếm, nhớ, tự tính từng nến | Số phiên tăng liên tiếp, Heikin Ashi, đỉnh / đáy gần nhất | Bài 6 |
| Vẽ nhãn, hộp, bảng | Nhãn Đỉnh / Đáy, hộp vùng tích luỹ, bảng tóm tắt ở góc | Bài 7 |
| Dùng khung khác, mã khác | Xu hướng tuần lọc tín hiệu ngày, đỉnh / đáy phiên hôm qua trên biểu đồ phút, so với VNINDEX, dòng tiền chủ động | Bài 8 |
| Viết chiến lược | Mua khi EMA cắt lên, bán khi cắt xuống, dừng lỗ 7 % | Bài 9 |
| Kiểm thử | Lợi nhuận, sụt giảm, tỷ lệ thắng theo luật T+2, lô 100, biên độ; Monte Carlo | Bài 10 |
| Chọn tham số mà không tự lừa mình | Tối ưu, walk-forward, ngoài mẫu | Bài 11 |
| Chạy điều kiện trên cả thị trường | Lọc VN30 bằng script, mở sang Quant AI Studio | Bài 12 |
Lộ trình đọc
- 1. Bắt đầu — Script đầu tiên trong 5 phút, rồi Khái niệm nền: nến, chuỗi, ngăn vẽ, tham số, và đủ JavaScript để đọc hiểu mọi ví dụ.
- 2. Học từng bước — 12 bài học, mỗi bài một kỹ năng, bài sau dùng lại bài trước. Mỗi bài có mã hoàn chỉnh, giải thích từng dòng và bài tập nhỏ kèm lời giải.
- 3. Tra cứu — Tham chiếu đầy đủ mọi hàm, thuộc tính, tuỳ chọn: chữ ký, tham số, giá trị trả về, ví dụ, lưu ý. Tra nhanh gom tất cả vào một trang.
- 4. Dùng ngay — Thư viện mẫu: hơn 40 chỉ báo và chiến lược hoàn chỉnh có chú thích, chép về chỉnh tiếp.
- 5. Gỡ rối — Lỗi thường gặp theo đúng chữ trình soạn báo, Hỏi đáp và mẹo, Chuyển từ Pine Script nếu bạn đến từ TradingView.
- 6. Nhờ trợ lý — Nhờ Copilot viết script: mô tả bằng lời, Copilot viết, chạy thử, tự sửa lỗi.
Ba điều nên nhớ ngay từ đầu
- Script tính trên cả chuỗi nến một lúc.
ta.ema(d.close, 20)là cả đường EMA của mọi nến, không phải một con số. Vì vậy phép so sánh viết bằng hàm:a.gt(b)(lớn hơn),a.and(b)(và) — không viếta > b,a && b. Vì sao. - Không nhìn trước tương lai. Mọi giá trị ở một nến chỉ được dùng thông tin của nến đó và các nến trước. Ngôn ngữ chặn sẵn các cách đọc nến sau (
shift(-1)báo lỗi) để tín hiệu bạn thấy trên lịch sử giống hệt tín hiệu sẽ hiện khi giao dịch thật. - Kết quả quá khứ không bảo đảm tương lai. Chiến lược mẫu trong chương chỉ để học cách viết; không phải khuyến nghị mua bán. Bài 11 chỉ cách kiểm một chiến lược có thật sự vững hay chỉ may mắn.
Cùng ngôn ngữ với Quant AI Studio
FireAnt Script dùng chung bộ hàm với Quant AI Studio (ta.*, param.*, phép của chuỗi). Khác nhau ở chỗ tính:
| Trên biểu đồ (chương này) | Trong Quant AI Studio | |
|---|---|---|
| Dữ liệu | Một mã, khung của biểu đồ (phút, giờ, ngày, tuần…) | Cả rổ nhiều mã, nến ngày |
| Khai báo | indicator(...), strategy(...), library(...) | strategy(...), screen(...), research(...) |
Tính theo từng nến (onBar), đối tượng vẽ, bảng | Có | Không |
VNINDEX (d.bench) | Có | Có |
Mã khác (d.symbol), nến nhỏ bên trong mỗi nến (d.ltf), dòng tiền chủ động (d.flow) | Có | Không |
Phép giữa các mã (rank, topN…), BCTC, khối ngoại, vĩ mô | Không | Có |
Một chiến lược viết bằng signals chạy được ở cả hai nơi: ⋯ › Mở trong Quant AI Studio đưa nó sang Studio để chạy trên cả rổ (Bài 12).
This chapter teaches you to write your own indicators and strategies for FireAnt Chart with FireAnt Script — even if you have never programmed before. You will start with a three-line moving average, then work up to stateful indicators, drawing objects, alerts, strategies with stop losses, and backtesting in a way you can trust.
Every code snippet in this chapter runs: copy it (the ⧉ button in the corner of the code block), paste it into the script editor and click Thêm vào biểu đồ (Add to chart). These snippets are tested automatically on FireAnt Terminal's own script engine every time the documentation changes.
This chapter is about the language. The buttons, tabs and tables of the script pane (library, saving, parameters, backtesting, log, alerts, screening) are described on the FireAnt Script page — skim that page first.
What you can do with FireAnt Script
| You want to | Example | Learn in |
|---|---|---|
| Draw your own lines on price | EMA 20 colored green when price is above it, red when below | Lesson 1 |
| Build separate-pane indicators with zones | RSI with shaded overbought / oversold zones | Lesson 2 |
| Mark signals | Arrows when MACD crosses up, background shading on volume-spike sessions, candle coloring | Lesson 3 |
| Let users adjust numbers | Periods, thresholds, a moving-average type picked from a list | Lesson 4 |
| Get notified | Alert when RSI crosses above 30 — on the FireAnt server, even when you close the chart | Lesson 5 |
| Count, remember and calculate per candle | Consecutive up sessions, Heikin Ashi, latest high / low | Lesson 6 |
| Draw labels, boxes, tables | Đỉnh (High) / Đáy (Low) labels, consolidation boxes, a summary table in the corner | Lesson 7 |
| Use other timeframes and tickers | Weekly trend filtering daily signals, yesterday's session high / low on a minute chart, comparison with VNINDEX, active order flow | Lesson 8 |
| Write strategies | Buy when the EMA crosses up, sell when it crosses down, 7% stop loss | Lesson 9 |
| Backtest | Return, drawdown and win rate under T+2, 100-share lots and price bands; Monte Carlo | Lesson 10 |
| Pick parameters without fooling yourself | Optimization, walk-forward, out-of-sample | Lesson 11 |
| Run conditions across the whole market | Screen VN30 with a script, open it in Quant AI Studio | Lesson 12 |
Reading path
- 1. Get started — Your first script in 5 minutes, then Core concepts: bars, series, panes, parameters, and just enough JavaScript to read every example.
- 2. Learn step by step — 12 lessons, one skill each, each building on the previous one. Every lesson has complete code, a line-by-line explanation and a small exercise with a solution.
- 3. Look things up — the full reference for every function, property and option: signature, parameters, return value, examples, notes. Quick reference puts it all on one page.
- 4. Use right away — the template library: more than 40 complete, annotated indicators and strategies to copy and adapt.
- 5. Troubleshoot — Common errors listed by the exact message the editor shows, FAQ and tips, and Moving from Pine Script if you come from TradingView.
- 6. Ask the assistant — Have Copilot write a script: describe it in words, Copilot writes it, test-runs it and fixes its own errors.
Three things to remember from the start
- A script calculates on the whole candle series at once.
ta.ema(d.close, 20)is the entire EMA line across all candles, not a single number. That is why comparisons are written as functions:a.gt(b)(greater than),a.and(b)(and) — nota > b,a && b. Why. - No looking into the future. Every value on a candle may only use information from that candle and earlier ones. The language blocks ways of reading later candles (
shift(-1)raises an error), so the signals you see on history are exactly the signals that would appear in live trading. - Past results do not guarantee the future. The sample strategies in this chapter are only for learning how to write code; they are not buy or sell recommendations. Lesson 11 shows how to check whether a strategy is truly robust or just lucky.
The same language as Quant AI Studio
FireAnt Script shares its function set with Quant AI Studio (ta.*, param.*, series operations). The difference is where it calculates:
| On the chart (this chapter) | In Quant AI Studio | |
|---|---|---|
| Data | One ticker, the chart's timeframe (minute, hour, day, week…) | A whole basket of tickers, daily candles |
| Declarations | indicator(...), strategy(...), library(...) | strategy(...), screen(...), research(...) |
Per-candle calculation (onBar), drawing objects, tables | Yes | No |
VNINDEX (d.bench) | Yes | Yes |
Other tickers (d.symbol), smaller candles inside each candle (d.ltf), active order flow (d.flow) | Yes | No |
Cross-ticker operations (rank, topN…), BCTC, foreign investors, macro | No | Yes |
A strategy written with signals runs in both places: ⋯ › Mở trong Quant AI Studio (Open in Quant AI Studio) brings it into the Studio to run on a whole basket (Lesson 12).
이 장에서는 FireAnt Script로 FireAnt Chart용 지표와 전략을 직접 작성하는 방법을 배웁니다. 프로그래밍을 해 본 적이 없어도 괜찮습니다. 세 줄짜리 이동평균선으로 시작해, 상태를 가진 지표, 그리기 객체, 알림, 손절이 있는 전략, 그리고 결과를 믿을 수 있도록 검증하는 방법까지 차근차근 나아갑니다.
이 장의 모든 코드는 실행됩니다. 코드 블록 모서리의 ⧉ 버튼으로 복사해 스크립트 편집기에 붙여 넣은 뒤 Thêm vào biểu đồ(차트에 추가)를 누르면 됩니다. 이 코드들은 문서가 바뀔 때마다 FireAnt Terminal의 스크립트 실행기에서 자동으로 검사됩니다.
이 장은 언어를 다룹니다. 스크립트 패널의 버튼, 탭, 표(라이브러리, 저장, 매개변수, 테스트, 로그, 알림, 종목 필터)는 FireAnt Script 페이지에 설명되어 있으니 먼저 훑어보는 것이 좋습니다.
FireAnt Script로 할 수 있는 일
| 원하는 것 | 예시 | 배울 곳 |
|---|---|---|
| 가격 위에 나만의 선 그리기 | 가격이 선 위에 있으면 초록, 아래면 빨강으로 칠하는 EMA 20 | 1강 |
| 영역이 있는 별도 패널 지표 | 과매수 / 과매도 구간을 칠한 RSI | 2강 |
| 신호 표시 | MACD 상향 교차 시 화살표, 거래량 급증 세션 배경 칠하기, 캔들 색칠 | 3강 |
| 사용자가 숫자를 조정하게 하기 | 기간, 기준값, 목록에서 고르는 이동평균 유형 | 4강 |
| 알림 받 기 | RSI가 30을 상향 돌파하면 알림 — 차트를 닫아도 FireAnt 서버에서 | 5강 |
| 캔들마다 세고, 기억하고, 직접 계산하기 | 연속 상승 세션 수, Heikin Ashi, 최근 고점 / 저점 | 6강 |
| 라벨, 박스, 표 그리기 | Đỉnh(고점) / Đáy(저점) 라벨, 횡보 구간 박스, 모서리의 요약 표 | 7강 |
| 다른 시간 프레임, 다른 종목 사용 | 주봉 추세로 일봉 신호 거르기, 분봉 차트에 전일 고점 / 저점, VNINDEX와 비교, 능동 자금 흐름 | 8강 |
| 전략 작성 | EMA 상향 교차 시 매수, 하향 교차 시 매도, 손절 7 % | 9강 |
| 테스트 | T+2 규칙, 100주 단위, 가격제한폭을 반영한 수익, 낙폭, 승률; Monte Carlo | 10강 |
| 자신을 속이지 않고 매개변수 고르기 | 최적화, walk-forward, 표본 외 | 11강 |
| 시장 전체에 조건 실행 | 스크립트로 VN30 필터링, Quant AI Studio로 열기 | 12강 |
읽는 순서
- 1. 시작하기 — 5분 만에 첫 스크립트, 이어서 기본 개념: 봉, 시리즈, 그리기 영역, 파라미터, 그리고 모든 예제를 읽을 만큼의 JavaScript.
- 2. 단계별 학습 — 12개 강의, 강의마다 한 가지 기술을 다루며 뒤 강의가 앞 강의를 이어 씁니다. 각 강의에는 완성된 코드, 줄별 설명, 해답이 있는 작은 연습 문제가 있습니다.
- 3. 찾아보기 — 모든 함수·속성·옵션의 전체 레퍼런스: 시그니처, 파라미터, 반환값, 예제, 주의 사항. 빠른 참조는 모든 것을 한 페이지에 모았습니다.
- 4. 바로 사용 — 템플릿 라이브러리: 주석이 달린 완성형 지표와 전략 40개 이상, 복사해서 고쳐 쓰세요.
- 5. 문제 해결 — 편집기가 표시하는 문구 그대로 정리한 자주 발생하는 오류, FAQ와 팁, TradingView에서 오셨다면 Pine Script에서 옮기기.
- 6. 어시스턴트에게 맡기기 — Copilot에게 스크립트 작성 요청: 말로 설명하면 Copilot이 작성하고, 실행해 보고, 오류를 스스로 고칩니다.
처음부터 기억할 세 가지
- 스크립트는 캔들 시계열 전체를 한 번에 계산합니다.
ta.ema(d.close, 20)은 숫자 하나가 아니라 모든 캔들의 EMA 선 전체입니다. 그래서 비교는 함수로 씁니다:a.gt(b)(보다 크다),a.and(b)(그리고).a > b,a && b로 쓰지 않습니다. 이유. - 미래를 미리 보지 않습니다. 한 캔들의 모든 값은 그 캔들과 이전 캔들의 정보만 사용합니다. 언어가 이후 캔들을 읽는 방법을 미리 막아 두었기 때문에(
shift(-1)은 오류) 과거 데이터에서 보는 신호가 실제 거래할 때 나타날 신호와 똑같습니다. - 과거 결과가 미래를 보장하지 않습니다. 이 장의 예제 전략은 작성법을 배우기 위한 것일 뿐, 매매 권유가 아닙니다. 11강에서 전략이 정말 견고한지, 단지 운이 좋았는지 검증하는 방법을 보여 줍니다.
Quant AI Studio와 같은 언어
FireAnt Script는 Quant AI Studio와 같은 함수 세트(ta.*, param.*, 시계열 연산)를 사용합니다. 차이는 계산 방식에 있습니다.
| 차트에서(이 장) | Quant AI Studio에서 | |
|---|---|---|
| 데이터 | 한 종목, 차트의 시간 프레임(분, 시간, 일, 주…) | 여러 종목의 바스켓 전체, 일봉 |
| 선언 | indicator(...), strategy(...), library(...) | strategy(...), screen(...), research(...) |
캔들별 계산(onBar), 그리기 객체, 표 | 예 | 아니요 |
VNINDEX(d.bench) | 예 | 예 |
다른 종목(d.symbol), 각 캔들 안의 작은 캔들(d.ltf), 능동 자금 흐름(d.flow) | 예 | 아니요 |
종목 간 연산(rank, topN…), BCTC, 외국인, 거시경제 | 아니요 | 예 |
signals로 작성한 전략은 두 곳 모두에서 실행됩니다. ⋯ › Mở trong Quant AI Studio(Quant AI Studio에서 열기)를 누르면 Studio로 보내 바스켓 전체에서 실행합니다(12강).
本章教您用 FireAnt Script 为 FireAnt Chart 自行编写指标和策略——即使您从未编过程。您将从一条三行代码的移动平均线开始，逐步学到带状态的指标、绘图对象、提醒、带止损的策略，以及如何进行测试才能让结果可信。
本章中的每段代码都能运行：复制（代码块角落的 ⧉ 按钮），粘贴到脚本编辑器，然后点击 Thêm vào biểu đồ（添加到图表）。每当文档更新时，这些代码都会在 FireAnt Terminal 自身的脚本运行器上自动检验。
本章讲的是语言。脚本窗格的按钮、标签页和面板（库、保存、参数、测试、日志、提醒、选股）在 FireAnt Script 页面中介绍——建议先浏览该页面。
FireAnt Script 能做什么
| 您想 | 示例 | 学习位置 |
|---|---|---|
| 在价格上画您自己的线 | EMA 20，价格在线上方时为绿色，下方时为红色 | 第 1 课 |
| 带区域的独立窗格指标 | 超买 / 超卖区域着色的 RSI | 第 2 课 |
| 标记信号 | MACD 上穿时的箭头、放量交易时段的背景着色、K 线着色 | 第 3 课 |
| 让用户调整数字 | 周期、阈值、从列表中选择移动平均线类型 | 第 4 课 |
| 接收通知 | RSI 上穿 30 时提醒——在 FireAnt 服务器上运行，即使您关闭了图表 | 第 5 课 |
| 逐根 K 线计数、记忆、自行计算 | 连续上涨的交易时段数、Heikin Ashi、最近的高点 / 低点 | 第 6 课 |
| 绘制标签、方框、表格 | Đỉnh（高点）/ Đáy（低点）标签、盘整区方框、角落的汇总表 | 第 7 课 |
| 使用其他周期、其他代码 | 用周趋势过滤日线信号、在分钟图上显示昨日交易时段的高点 / 低点、与 VNINDEX 比较、主动资金流 | 第 8 课 |
| 编写策略 | EMA 上穿时买入，下穿时卖出，止损 7% | 第 9 课 |
| 测试 | 按 T+2 、100 股一手、涨跌幅限制规则计算收益、回撤、胜率；Monte Carlo | 第 10 课 |
| 选择参数而不自欺欺人 | 优化、walk-forward、样本外 | 第 11 课 |
| 在全市场运行条件 | 用脚本筛选 VN30，在 Quant AI Studio 中打开 | 第 12 课 |
阅读路线
- 1. 入门 — 5 分钟写出第一个脚本，然后是基础概念：K 线、序列、绘图区、参数，以及读懂所有示例所需的 JavaScript。
- 2. 逐步学习 — 12 节课，每节一个技能，后一节沿用前一节。每节课都有完整代码、逐行讲解和附答案的小练习。
- 3. 查阅 — 所有函数、属性、选项的完整参考：签名、参数、返回值、示例、注意事项。速查把全部内容汇总在一页。
- 4. 直接使用 — 模板库：40 多个带注释的完整指标和策略，复制后再修改。
- 5. 排错 — 按编辑器提示原文整理的常见错误、问答与技巧，如果您来自 TradingView，还有从 Pine Script 迁移。
- 6. 请助手帮忙 — 让 Copilot 编写脚本：用文字描述，Copilot 编写、试运行并自行修正错误。
一开始就该记住的三件事
- 脚本一次性在整个 K 线序列上计算。
ta.ema(d.close, 20)是所有 K 线上的整条 EMA 线，而不是一个数字。因此比较运算用函数来写：a.gt(b)（大于）、a.and(b)（且）——不写a > b、a && b。原因。 - 不偷看未来。 某根 K 线上的任何值都只能使用该 K 线及之前 K 线的信息。语言预先禁止了读取后面 K 线的写法（
shift(-1)会报错），这样您在历史上看到的信号与真实交易时出现的信号完全一致。 - 过去的结果不保证未来。 本章的示例策略只用于学习写法；并非买卖建议。第 11 课介绍如何检验一个策略是真正稳健还是只是运气。
与 Quant AI Studio 使用同一语言
FireAnt Script 与 Quant AI Studio 共用同一套函数（ta.*、param.*、序列运算）。区别在于计算的位置：
| 图表上（本章） | Quant AI Studio 中 | |
|---|---|---|
| 数据 | 单个代码，图表的周期（分钟、小时、日、周…） | 多代码的整个篮子，日 K 线 |
| 声明 | indicator(...)、strategy(...)、library(...) | strategy(...)、screen(...)、research(...) |
逐 K 线计算（onBar）、绘图对象、表格 | 有 | 无 |
VNINDEX（d.bench） | 有 | 有 |
其他代码（d.symbol）、每根 K 线内部的小 K 线（d.ltf）、主动资金流（d.flow） | 有 | 无 |
跨代码运算（rank、topN…）、BCTC、外资、宏观 | 无 | 有 |
用 signals 编写的策略在两处都能运行：⋯ › Mở trong Quant AI Studio（在 Quant AI Studio 中打开）会把它带到 Studio，在整个篮子上运行（第 12 课）。