语法指南 | 发明者量化

内置函数

结构体

内置变量

KLineChart

该函数用于采用类似Pine语言的绘图方式，在策略运行时进行自定义绘图。


    
    
    
KLineChart(options)

示例

如果需要在策略自定义画图区域进行画图，必须先创建图表控制对象，使用KLineChart()函数即可创建该对象。KLineChart()函数的参数为一个图表配置结构，参考代码中使用的图表配置结构非常简单：{overlay: true}。

该图表配置结构仅设置将画图内容输出在图表主图上。如果overlay设置为假值（例如false），则图表内容将全部输出在副图上；如果需要指定某个画图函数在主图上绘制，也可以在具体的函数调用中将参数overlay指定为真值（例如true）。


    javascript
    
    
function main() {
    // 调用KLineChart函数创建图表控制对象c
    let c = KLineChart({
        overlay: true
    })

    // 使用现货交易所对象测试，获取K线数据。如果使用期货交易所对象测试，需要先设置合约
    let bars = exchange.GetRecords()
    if (!bars) {
        return
    }

    // 遍历K线数据执行画图操作，每次画图操作必须以```c.begin(bar)```函数调用作为起始，以```c.close(bar)```函数调用作为结束。
    bars.forEach(function(bar, index) {
        c.begin(bar)
        c.barcolor(bar.Close > bar.Open ? 'rgba(255, 0, 0, 0.2)' : 'rgba(0, 0, 0, 0.2)')
        if (bar.Close > bar.Open) {
            c.bgcolor('rgba(0, 255, 0, 0.5)')
        }
        let h = c.plot(bar.High, 'high')
        let l = c.plot(bar.Low, 'low')

        c.fill(h, l, {
            color: bar.Close > bar.Open ? 'rgba(255, 0, 0, 0.2)' : 'rgba(255, 0, 0, 0.2)'
        })
        c.hline(bar.High)
        c.plotarrow(bar.Close - bar.Open)
        c.plotshape(bar.Low, {
            style: 'diamond'
        })
        c.plotchar(bar.Close, {
            char: 'X'
        })
        c.plotcandle(bar.Open*0.9, bar.High*0.9, bar.Low*0.9, bar.Close*0.9)
        if (bar.Close > bar.Open) {
            // long/short/closelong/closeshort
            c.signal("long", bar.High, 1.5)
        } else if (bar.Close < bar.Open) {
            c.signal("closelong", bar.Low, 1.5)
        }
        c.close(bar)
    })
}


    python
    
    
def main():
    # 调用KLineChart函数创建图表控制对象c
    c = KLineChart({
        "overlay": True
    })

    # 使用现货交易所对象测试，获取K线数据。如果使用期货交易所对象测试，需要先设置合约
    bars = exchange.GetRecords()
    if not bars:
        return

    for bar in bars:
        c.begin(bar)
        c.barcolor('rgba(255, 0, 0, 0.2)' if bar.Close > bar.Open else 'rgba(0, 0, 0, 0.2)')
        if bar.Close > bar.Open:
            c.bgcolor('rgba(0, 255, 0, 0.5)')

        h = c.plot(bar.High, 'high')
        l = c.plot(bar.Low, 'low')

        c.fill(h, l, 'rgba(255, 0, 0, 0.2)' if bar.Close > bar.Open else 'rgba(255, 0, 0, 0.2)')
        c.hline(bar.High)
        c.plotarrow(bar.Close - bar.Open)
        c.plotshape(bar.Low, style = 'diamond')
        c.plotchar(bar.Close, char = 'X')
        c.plotcandle(bar.Open*0.9, bar.High*0.9, bar.Low*0.9, bar.Close*0.9)
        if bar.Close > bar.Open:
            # long/short/closelong/closeshort
            c.signal("long", bar.High, 1.5)
        elif bar.Close < bar.Open:
            c.signal("closelong", bar.Low, 1.5)

        c.close(bar)


    rust
    
    
fn main() {
    // 调用KLineChart::new创建图表控制对象c
    let mut c = KLineChart::new(r#"{"overlay": true}"#);

    // 使用现货交易所对象测试，获取K线数据。如果使用期货交易所对象测试，需要先设置合约
    let bars = exchange.GetRecords(None, None, None).unwrap();

    // 遍历K线数据执行画图操作，每次画图操作必须以c.begin(bar)函数调用作为起始，以c.close()函数调用作为结束。
    for bar in &bars {
        c.begin(bar);
        c.barcolor(if bar.Close > bar.Open { "rgba(255, 0, 0, 0.2)" } else { "rgba(0, 0, 0, 0.2)" }, "{}");
        if bar.Close > bar.Open {
            c.bgcolor("rgba(0, 255, 0, 0.5)", "{}");
        }
        let h = c.plot(bar.High, r#"{"title": "high"}"#);
        let l = c.plot(bar.Low, r#"{"title": "low"}"#);

        c.fill(h, l, if bar.Close > bar.Open { r#"{"color": "rgba(255, 0, 0, 0.2)"}"# } else { r#"{"color": "rgba(255, 0, 0, 0.2)"}"# });
        c.hline(bar.High, "{}");
        c.plotarrow(bar.Close - bar.Open, "{}");
        c.plotshape(bar.Low > 0.0, r#"{"style": "diamond"}"#);
        c.plotchar(bar.Close > 0.0, r#"{"char": "X"}"#);
        c.plotcandle(bar.Open * 0.9, bar.High * 0.9, bar.Low * 0.9, bar.Close * 0.9, "{}");
        if bar.Close > bar.Open {
            // long/short/closelong/closeshort
            c.signal("long", bar.High, 1.5, "long");
        } else if bar.Close < bar.Open {
            c.signal("closelong", bar.Low, 1.5, "closelong");
        }
        c.close();
    }
}


    c++
    
    
// 暂不支持

使用 pricePrecision 和 volumePrecision 参数控制图表数据的显示精度。可根据实际需求设置价格与成交量的显示精度，例如对于价格波动较大的品种，可将精度设置为 0 以显示整数；对于价格较为精细的品种，可设置为 2 或更高精度。


    javascript
    
    
function main() {
    // 创建图表控制对象，将价格精度与成交量精度均设置为 0（即显示整数）
    let c = KLineChart({
        overlay: true,
        pricePrecision: 0,   // 价格数据精度，设置为 2 即保留 2 位小数
        volumePrecision: 0   // 成交量数据精度
    })

    // 根据交易所类型选择合适的交易对
    let symbol = exchange.GetName().includes("Futures_") ? "ETH_USDT.swap" : "ETH_USDT"
    Log("Test symbol:", symbol)

    // 获取 K 线数据
    let bars = exchange.GetRecords(symbol)
    if (!bars) {
        return
    }

    // 遍历 K 线数据并绘制图表
    bars.forEach(function(bar, index) {
        c.begin(bar)
        c.barcolor(bar.Close > bar.Open ? 'rgba(255, 0, 0, 0.2)' : 'rgba(0, 0, 0, 0.2)')
        c.plot(bar.High, 'high')
        c.plot(bar.Low, 'low')
        c.close(bar)
    })
}


    python
    
    
def main():
    # 创建图表控制对象，将价格精度与成交量精度均设置为 0（即显示整数）
    c = KLineChart({
        "overlay": True,
        "pricePrecision": 0,   # 价格数据精度，设置为 2 即保留 2 位小数
        "volumePrecision": 0   # 成交量数据精度
    })

    # 根据交易所类型选择合适的交易对
    exName = exchange.GetName()
    symbol = "ETH_USDT.swap" if "Futures_" in exName else "ETH_USDT"
    Log("Test symbol:", symbol)

    # 获取 K 线数据
    bars = exchange.GetRecords(symbol)
    if not bars:
        return

    # 遍历 K 线数据并绘制图表
    for bar in bars:
        c.begin(bar)
        c.barcolor('rgba(255, 0, 0, 0.2)' if bar.Close > bar.Open else 'rgba(0, 0, 0, 0.2)')
        c.plot(bar.High, 'high')
        c.plot(bar.Low, 'low')
        c.close(bar)


    rust
    
    
fn main() {
    // 创建图表控制对象，将价格精度与成交量精度均设置为 0（即显示整数）
    // pricePrecision 为价格数据精度，设置为 2 即保留 2 位小数；volumePrecision 为成交量数据精度
    let mut c = KLineChart::new(r#"{"overlay": true, "pricePrecision": 0, "volumePrecision": 0}"#);

    // 根据交易所类型选择合适的交易对
    let symbol = if exchange.GetName().contains("Futures_") { "ETH_USDT.swap" } else { "ETH_USDT" };
    Log!("Test symbol:", symbol);

    // 获取 K 线数据
    let bars = exchange.GetRecords(symbol, None, None).unwrap();

    // 遍历 K 线数据并绘制图表
    for bar in &bars {
        c.begin(bar);
        c.barcolor(if bar.Close > bar.Open { "rgba(255, 0, 0, 0.2)" } else { "rgba(0, 0, 0, 0.2)" }, "{}");
        c.plot(bar.High, r#"{"title": "high"}"#);
        c.plot(bar.Low, r#"{"title": "low"}"#);
        c.close();
    }
}


    c++
    
    
// 暂不支持

绘图操作中支持的Pine语言绘图接口函数如下：

barcolor：设置K线颜色。

barcolor(color, offset, editable, show_last, title, display)

display参数的可选值为："none", "all"


    javascript
    
    
c.barcolor(bar.Close > bar.Open ? 'rgba(255, 0, 0, 0.2)' : 'rgba(0, 0, 0, 0.2)')   // 用法同上例中的参考代码，此处不再赘述


    python
    
    
c.barcolor('rgba(255, 0, 0, 0.2)' if bar.Close > bar.Open else 'rgba(0, 0, 0, 0.2)')


    rust
    
    
c.barcolor(if bar.Close > bar.Open { "rgba(255, 0, 0, 0.2)" } else { "rgba(0, 0, 0, 0.2)" }, "{}");   // 用法同上例中的参考代码，此处不再赘述


    c++
    
    
//  暂不支持

bgcolor：使用指定颜色填充K线背景。

bgcolor(color, offset, editable, show_last, title, display, overlay)

display参数的可选值为："none", "all"


    javascript
    
    
c.bgcolor('rgba(0, 255, 0, 0.5)')


    python
    
    
c.bgcolor('rgba(0, 255, 0, 0.5)')


    rust
    
    
c.bgcolor("rgba(0, 255, 0, 0.5)", "{}");


    c++
    
    
// 暂不支持

plot：在图表上绘制一系列数据。

plot(series, title, color, linewidth, style, trackprice, histbase, offset, join, editable, show_last, display)

style参数的可选值为："stepline_diamond", "stepline", "cross", "areabr", "area", "circles", "columns", "histogram", "linebr", "line"

display参数的可选值为："none", "all"


    javascript
    
    
c.plot(bar.High, 'high')

c.plot(bar.Open < bar.Close ? NaN : bar.Close, "Close", {style: "linebr"})  // 支持绘制不连续的数据线


    python
    
    
h = c.plot(bar.High, 'high')

h = c.plot(None if bar.Open < bar.Close else bar.Close, "Close", style = "linebr")  # 支持绘制不连续的数据线


    rust
    
    
let h = c.plot(bar.High, r#"{"title": "high"}"#);

c.plot(if bar.Open < bar.Close { f64::NAN } else { bar.Close }, r#"{"title": "Close", "style": "linebr"}"#);  // 支持绘制不连续的数据线


    c++
    
    
// 暂不支持

fill，使用指定的颜色填充两个绘图或hline之间的背景区域。 > fill(hline1, hline2, color, title, editable, fillgaps, display) > display参数可选："none", "all"

由于JavaScript语言无法根据函数形参名称指定传入参数，为解决此问题，可以使用{key: value}结构为指定的形参名称传入参数。例如，参考代码中使用{color: bar.Close > bar.Open ? 'rgba(255, 0, 0, 0.2)' : 'rgba(255, 0, 0, 0.2)'}为fill函数的color参数赋值。

如需连续为多个形参名称指定参数，可以使用{key1: value1, key2: value2, key3: value3}。

例如，本示例中额外指定了一个title参数：{color: bar.Close > bar.Open ? 'rgba(255, 0, 0, 0.2)' : 'rgba(255, 0, 0, 0.2)', title: 'fill'}。

颜色值既可以使用'rgba(255, 0, 0, 0.2)'方式设置，也可以使用'#FF0000'方式设置。
```
    javascript
    
    
let h = c.plot(bar.High, 'high')
let l = c.plot(bar.Low, 'low')
c.fill(h, l, {color: bar.Close > bar.Open ? 'rgba(255, 0, 0, 0.2)' : 'rgba(255, 0, 0, 0.2)'})
```
```
    python
    
    
h = c.plot(bar.High, 'high')
l = c.plot(bar.Low, 'low')
c.fill(h, l, color = 'rgba(255, 0, 0, 0.2)' if bar.Close > bar.Open else 'rgba(255, 0, 0, 0.2)')
```
```
    rust
    
    
let h = c.plot(bar.High, r#"{"title": "high"}"#);
let l = c.plot(bar.Low, r#"{"title": "low"}"#);
c.fill(h, l, if bar.Close > bar.Open { r#"{"color": "rgba(255, 0, 0, 0.2)"}"# } else { r#"{"color": "rgba(255, 0, 0, 0.2)"}"# });
```
```
    c++
    
    
// 暂不支持
```
hline，在给定的固定价格水平上绘制水平线。

hline(price, title, color, linestyle, linewidth, editable, display)

linestyle参数可选："dashed", "dotted", "solid"

display参数可选："none", "all"
```
    javascript
    
    
c.hline(bar.High)
```
```
    python
    
    
c.hline(bar.High)
```
```
    rust
    
    
c.hline(bar.High, "{}");
```
```
    c++
    
    
// 暂不支持
```

plotarrow，在图表上绘制向上和向下的箭头。

plotarrow(series, title, colorup, colordown, offset, minheight, maxheight, editable, show_last, display)

display参数可选："none", "all"


    javascript
    
    
c.plotarrow(bar.Close - bar.Open)


    python
    
    
c.plotarrow(bar.Close - bar.Open)


    rust
    
    
c.plotarrow(bar.Close - bar.Open, "{}");


    c++
    
    
// 暂不支持

plotshape，在图表上绘制可视化形状。

plotshape(series, title, style, location, color, offset, text, textcolor, editable, size, show_last, display)
style参数可选："diamond", "square", "label_down", "label_up", "arrow_down", "arrow_up", "circle", "flag", "triangle_down", "triangle_up", "cross", "xcross"
location参数可选："abovebar", "belowbar", "top", "bottom", "absolute"
size参数可选："10px", "14px", "20px", "40px", "80px"，分别对应Pine语言中的size.tiny、size.small、size.normal、size.large、size.huge
size.auto等同于size.small。
display参数可选："none", "all"
```
    javascript
    
    
c.plotshape(bar.Low, {style: 'diamond'})
```
```
    python
    
    
c.plotshape(bar.Low, style = 'diamond')
```
```
    rust
    
    
c.plotshape(bar.Low > 0.0, r#"{"style": "diamond"}"#);
```
```
    c++
    
    
// 暂不支持
```
plotchar，在图表上使用任意给定的Unicode字符绘制可视化形状。

plotchar(series, title, char, location, color, offset, text, textcolor, editable, size, show_last, display)
location参数可选："abovebar", "belowbar", "top", "bottom", "absolute"
size参数可选："10px", "14px", "20px", "40px", "80px"，分别对应Pine语言中的size.tiny、size.small、size.normal、size.large、size.huge
size.auto等同于size.small。
display参数可选："none", "all"
```
    javascript
    
    
c.plotchar(bar.Close, {char: 'X'})
```
```
    python
    
    
c.plotchar(bar.Close, char = 'X')
```
```
    rust
    
    
c.plotchar(bar.Close > 0.0, r#"{"char": "X"}"#);
```
```
    c++
    
    
// 暂不支持
```

plotcandle，在图表上绘制K线图。

plotcandle(open, high, low, close, title, color, wickcolor, editable, show_last, bordercolor, display)
display参数可选："none", "all"


    javascript
    
    
c.plotcandle(bar.Open*0.9, bar.High*0.9, bar.Low*0.9, bar.Close*0.9)


    python
    
    
c.plotcandle(bar.Open*0.9, bar.High*0.9, bar.Low*0.9, bar.Close*0.9)


    rust
    
    
c.plotcandle(bar.Open * 0.9, bar.High * 0.9, bar.Low * 0.9, bar.Close * 0.9, "{}");


    c++
    
    
// 暂不支持

signal，此为Pine语言中不存在的函数，此处用于绘制买卖信号。

signal(direction, price, qty, id)

传入的参数"long"表示交易方向，可选"long"、"closelong"、"short"、"closeshort"。传入的参数bar.High表示标记信号在Y轴上的位置。
传入的参数1.5表示信号的交易数量。可传入第四个参数以替换默认绘制的文本内容；信号标记的默认文本为交易方向，例如："closelong"。
```
    javascript
    
    
c.signal("long", bar.High, 1.5)
```
```
    python
    
    
c.signal("long", bar.High, 1.5)
```
```
    rust
    
    
c.signal("long", bar.High, 1.5, "long");
```
```
    c++
    
    
// 暂不支持
```
reset，此为Pine语言中不存在的函数，用于清空图表数据。

reset(remain)

reset()方法可接受一个参数remain，用于指定保留数据的条数。若不传入remain参数，则表示清除全部数据。
```
    javascript
    
    
c.reset()
```
```
    python
    
    
c.reset()
```
```
    rust
    
    
c.reset(0);
```
```
    c++
    
    
// 暂不支持
```

返回值

类型描述

object

图表对象。

KLineChart()函数返回的图表对象包含多个方法，其中需要特别注意begin(bar)和close(bar)。在遍历K线数据执行绘图操作时，绘图操作必须以begin(bar)函数调用作为起始，并以close(bar)函数调用作为结束。

参数

名称类型必填描述

options

object / object数组

是

options参数为图表配置对象，支持以下属性：

overlay：布尔值，用于设置绘图内容是否叠加输出到主图。设置为true时在主图显示，设置为false时在副图显示。
pricePrecision：数字，价格数据精度，用于控制图表中价格数据的小数位数。例如，设置为2表示保留2位小数，设置为0表示不保留小数（四舍五入为整数）。
volumePrecision：数字，成交量数据精度，用于控制图表中成交量数据的小数位数。例如，设置为2表示保留2位小数，设置为0表示不保留小数（四舍五入为整数）。

参考

Chart

备注

策略自定义绘图只能选用KLineChart()函数或Chart()函数两种方式中的一种。有关KLineChart()函数调用时所涉及的颜色、样式等设置，请参阅使用KLineChart函数绘图的专题文章。

pricePrecision和volumePrecision参数用于控制图表中数据的显示精度。当未设置这些参数时，图表将使用默认精度显示数据。设置精度参数后，图表中的价格和成交量数据将按照指定的小数位数进行四舍五入显示，这有助于简化图表显示、提升可读性。