HttpQuery-options

此JSON结构用于配置HttpQuery函数和HttpQuery_Go函数发送HTTP请求的各项参数。

属性

参考

备注

使用范例：

            javascript
            
            
function main() {
    var options = {
        method: "POST",
        body: "a=10&b=20&c=30",
        charset: "UTF-8",
        cookie: "session_id=12345; lang=en",
        debug: false,
        headers: {"TEST-HTTP-QUERY": "123"},
        timeout: 1000
    }
    var ret = HttpQuery("http://127.0.0.1:8080", options)
    Log(ret)
}

以上代码执行时发出的HTTP报文：

            log
            
            
POST / HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Cookie: session_id=12345; lang=en
Host: 127.0.0.1:8080
Test-Http-Query: 123
Transfer-Encoding: chunked
User-Agent: Mozilla/5.0 (Macintosh; ...
Accept-Encoding: gzip, deflate, br

e
a=10&b=20&c=30
0

HttpQuery-return

此JSON结构为HttpQuery函数调用时，当参数options结构中指定debug字段为true时，HttpQuery函数调试模式返回的数据结构。

属性

参考

备注

返回的JSON数据结构示例：

            json
            
            
{
    "StatusCode": 302,
    "Header": {
        "Content-Type": ["text/html"],
        // ...
    },
    "Cookies": [{
        // ...
    }],
    "Trace": {},
    "Length": 154,
    "Body": "..."
}

LogStatus-table

此JSON结构用于配置策略状态栏中显示的表格内容。

属性

参考

备注

            javascript
            
            
function main() {
    var tbl = {
        type: "table",
        title: "标题",
        cols: ["列1", "列2", "列3"],
        rows: [
            ["行1列1", "行1列2", "行1列3"],
            ["行2列1", "行2列2", "行2列3"],
            ["行3列1", "行3列2", "行3列3"],
        ]
    }
    LogStatus("`" + JSON.stringify(tbl) + "`")
}

LogStatus-btnTypeOne

该JSON结构用于配置状态栏中的按钮控件，按钮控件JSON结构可以嵌入到状态栏表格JSON结构中。此结构为旧版本结构，平台目前仍然兼容，建议使用最新版本的按钮JSON结构。
状态栏按钮控件构造示例（按钮触发点击后，弹框中包含单个输入控件，通过input字段构造）：

            json
            
            
{
    "type": "button",
    "cmd": "open",
    "name": "开仓",
    "input": {
        "name": "开仓数量",
        "type": "number",
        "defValue": 1
    }
}

状态栏按钮控件点击触发后的弹框中的控件通过input或group字段设置。

属性

            json
            
            
{
    "name": "开仓数量",
    "type": "number",
    "defValue": 1,
    "description": "test"
}

参考

备注

状态栏中按钮JSON结构的class属性取值示例：

            javascript
            
            
function main() {
    var table = {
        type: "table",
        title: "状态栏按钮样式",
        cols: ["默认", "原始", "成功", "信息", "警告", "危险"],
        rows: [
            [
                {"type":"button", "class": "btn btn-xs btn-default", "name": "默认"},
                {"type":"button", "class": "btn btn-xs btn-primary", "name": "原始"},
                {"type":"button", "class": "btn btn-xs btn-success", "name": "成功"},
                {"type":"button", "class": "btn btn-xs btn-info", "name": "信息"},
                {"type":"button", "class": "btn btn-xs btn-warning", "name": "告警"},
                {"type":"button", "class": "btn btn-xs btn-danger", "name": "危险"}
            ]
        ]
    }
    LogStatus("`" + JSON.stringify(table) + "`")
}

group字段与input字段使用示例：

            javascript
            
            
function main() {
    // 状态栏按钮控件（设置input字段实现）testBtn1按钮触发的页面中的下拉框控件使用options字段设置选项，使用defValue字段设置默认选项。区别于本章其他示例中直接使用defValue设置选项。
    var testBtn1 = {
        type: "button",
        name: "testBtn1",
        cmd: "cmdTestBtn1",
        input: {name: "testBtn1ComboBox", type: "selected", options: ["A", "B"], defValue: 1}
    }

    /*
      状态栏按钮控件（设置input字段实现）testBtn2按钮触发的页面中的下拉框控件使用options字段设置选项，options字段中的选项不仅支持字符串，
      也支持使用```{text: "描述", value: "值"}```结构。使用defValue字段设置默认选项，默认选项可以是多选（通过数组结构实现多选）。多选需要设置额外的字段multiple为真值（true）。
    */
    var testBtn2 = {
        type: "button",
        name: "testBtn2",
        cmd: "cmdTestBtn2",
        input: {
            name: "testBtn2MultiComboBox",
            type: "selected",
            description: "实现下拉框多选",
            options: [{text: "选项A", value: "A"}, {text: "选项B", value: "B"}, {text: "选项C", value: "C"}],
            defValue: ["A", "C"],
            multiple: true
        }
    }

    // 状态栏分组按钮控件（设置group字段实现）testBtn3按钮触发的页面中的下拉框控件使用options字段设置选项，也支持直接使用defValue设置选项。
    var testBtn3 = {
        type: "button",
        name: "testBtn3",
        cmd: "cmdTestBtn3",
        group: [
            {name: "comboBox1", label: "labelComboBox1", description: "下拉框1", type: "selected", defValue: 1, options: ["A", "B"]},
            {name: "comboBox2", label: "labelComboBox2", description: "下拉框2", type: "selected", defValue: "A|B"},
            {name: "comboBox3", label: "labelComboBox3", description: "下拉框3", type: "selected", defValue: [0, 2], multiple: true, options: ["A", "B", "C"]},
            {
                name: "comboBox4",
                label: "labelComboBox4",
                description: "下拉框4",
                type: "selected",
                defValue: ["A", "C"],
                multiple: true,
                options: [{text: "选项A", value: "A"}, {text: "选项B", value: "B"}, {text: "选项C", value: "C"}, {text: "选项D", value: "D"}]
            }
        ]
    }
    while (true) {
        LogStatus("`" + JSON.stringify(testBtn1) + "`\n", "`" + JSON.stringify(testBtn2) + "`\n", "`" + JSON.stringify(testBtn3) + "`\n")
        var cmd = GetCommand()
        if (cmd) {
            Log(cmd)
        }
        Sleep(5000)
    }
}

LogStatus-btnTypeTwo

此JSON结构用于配置状态栏中的按钮控件，按钮控件JSON结构可以嵌入到状态栏表格JSON结构中。这是目前最新版本的按钮JSON结构。
状态栏按钮控件构造示例（按钮触发点击后，弹框中包含多个输入控件，通过group字段构造）：

            json
            
            
{
    "type": "button",
    "cmd": "open",
    "name": "开仓下单",
    "group": [{
        "type": "selected",
        "name": "tradeType",
        "label": "下单类型",
        "description": "市价单、限价单",
        "default": 0,
        "group": "交易设置",
        "settings": {
            "options": ["市价单", "限价单"],
            "required": true,
        }
    }, {
        "type": "selected",
        "name": "direction",
        "label": "交易方向",
        "description": "买入、卖出",
        "default": "buy",
        "group": "交易设置",
        "settings": {
            "render": "segment",
            "required": true,
            "options": [{"name": "买入", "value": "buy"}, {"name": "卖出", "value": "sell"}],
        }
    }, {
        "type": "number",
        "name": "price",
        "label": "价格",
        "description": "订单的价格",
        "group": "交易设置",
        "filter": "tradeType==1",
        "settings": {
            "required": true,
        }
    }, {
        "type": "number",
        "name": "amount",
        "label": "下单量",
        "description": "订单的下单量",
        "group": "交易设置",
        "settings": {
            "required": true,
        }
    }],
}

状态栏按钮控件点击触发后的弹框中的控件通过input或group字段设置。

属性

            json
            
            
{
    "type": "selected",
    "name": "test",
    "label": "topic",
    "description": "desc",
    "default": 1,
    "filter": "a>1",
    "group": "group1",
    "settings": { ... },    // 组件配置
}

参考

备注

支持双语设置：

            json
            
            
{
    type:'selected',
    name:'test',
    label:'选项｜options',
    description:'描述｜description',
    default:0,                            // 这里default默认值设置0，表示{name:'xxx|yyy',value:0}选项中的value值
    filter:'a>1&&a<10',
    group:'分组|group',
    settings:{
        multiple:true,
        customizable:true,
        options:[{name:'xxx|yyy',value:0}]
    }
}

Chart-options

此JSON用于配置自定义绘图函数Chart()的图表设置信息，图表库使用Highcharts。以下列出几个基本的配置字段。

属性

            json
            
            
{
    layout: 'single', // 不参于分组，单独显示, 默认为分组 'group'
    height: 300,      // 指定高度
}

参考

备注

简单的绘图示例：

            javascript
            
            
// 此chart在JavaScript语言中是对象，在使用Chart函数之前需要声明一个配置图表的对象变量chart
var chart = {
    // 该字段标记图表是否为股票图表，有兴趣的可以改成false运行查看效果
    __isStock: true,
    // 缩放工具
    tooltip: {xDateFormat: '%Y-%m-%d %H:%M:%S, %A'},
    // 标题
    title : { text : '差价分析图'},
    // 选择范围
    rangeSelector: {
        buttons: [{type: 'hour',count: 1, text: '1h'}, {type: 'hour',count: 3, text: '3h'}, {type: 'hour', count: 8, text: '8h'}, {type: 'all',text: 'All'}],
        selected: 0,
        inputEnabled: false
    },
    // 坐标轴横轴即X轴，当前设置的类型为时间
    xAxis: { type: 'datetime'},
    // 坐标轴纵轴即Y轴，默认数值随数据大小调整
    yAxis : {
        // 标题
        title: {text: '差价'},
        // 是否启用右侧纵轴
        opposite: false
    },
    // 数据系列，该属性保存各个数据系列（线条、K线图、标签等）
    series : [
        // 索引为0，data数组内存放该索引系列的数据
        {name : "line1", id : "线1,buy1Price", data : []},
        // 索引为1，设置了dashStyle:'shortdash'即设置为虚线
        {name : "line2", id : "线2,lastPrice", dashStyle : 'shortdash', data : []}
    ]
}
function main(){
    // 调用Chart函数，初始化图表
    var ObjChart = Chart(chart)
    // 清空
    ObjChart.reset()
    while(true){
        // 获取本次轮询的时间戳，即毫秒级时间戳，用于确定写入图表X轴的位置
        var nowTime = new Date().getTime()
        // 获取行情数据
        var ticker = _C(exchange.GetTicker)
        // 从行情数据的返回值中获取买一价
        var buy1Price = ticker.Buy
        // 获取最后成交价，为了使两条线不重合，我们加1
        var lastPrice = ticker.Last + 1
        // 用时间戳作为X值，买一价作为Y值传入索引0的数据序列
        ObjChart.add(0, [nowTime, buy1Price])
        // 同上
        ObjChart.add(1, [nowTime, lastPrice])
        Sleep(2000)
    }
}

KLineChart-options

此JSON用于设置自定义绘图函数KLineChart的图表配置信息。以下仅列出几个基本的配置字段。

属性

参考

备注

参考使用KLineChart函数画图的专题文章。

SetData-data

该JSON用于设置exchange.SetData()函数所要加载的数据。该JSON数据采用数组结构，其中每个元素也是一个数组，格式为[time, data]。

属性

参考

备注

回测系统中加载数据，策略回测运行时取出数据的示例：

            javascript
            
            
/*backtest
start: 2020-01-21 00:00:00
end: 2020-02-12 00:00:00
period: 1d
basePeriod: 1d
exchanges: [{"eid":"Bitfinex","currency":"BTC_USD"}]
*/
function main() {
    exchange.SetData("test", [[1579536000000, _D(1579536000000)], [1579622400000, _D(1579622400000)], [1579708800000, _D(1579708800000)]])
    while(true) {
        Log(exchange.GetData("test"))
        Sleep(1000 * 60 * 60 * 24)
    }
}

EventLoop-return

该JSON是EventLoop()函数返回的数据结构。EventLoop()函数监听以下事件：1、任意WebSocket可读数据事件；2、exchange.Go()、HttpQuery_Go()函数并发任务完成事件；3、JavaScript语言策略中threading.Thread()函数创建的线程发送的消息事件。

属性

参考

备注

使用exchange.Go()函数并发请求时，EventLoop()函数返回的事件数据结构。

            json
            
            
{
    "Seq":1,
    "Event":"Exchange_GetTrades",
    "ThreadId":0,
    "Index":3,
    "Nano":1682068771309583400
}

JavaScript语言策略中的并发执行线程（由threading.Thread()函数创建）使用线程对象的postMessage()函数发送消息时，接收消息的线程中EventLoop()函数会监听到以下事件数据结构：

            json
            
            
{
    "Seq":4,
    "Event":"thread",
    "ThreadId":1,
    "Index":0,
    "Nano":1727592066508674000
}

DBExec-return

该JSON是DBExec()函数返回的数据结构；使用Dial()函数创建的对象的exec()方法执行SQL语句时，也返回此JSON数据结构。

属性

参考

备注

查询数据库中的数据举例：

            json
            
            
{
    "columns":["TS","HIGH","OPEN","LOW","CLOSE","VOLUME"],
    "values":[
        [1518970320000,100,99.1,90,100,12345.6],
        [1518960320000,100,99.1,90,100,12345.6]
    ]
}

Thread.join-return

该JSON是Thread对象的成员函数join()返回的数据结构，用于保存JavaScript语言策略中并发线程的相关信息。Thread对象指的是线程对象，通过threading.Thread()方式创建。

属性

参考

备注

以下代码测试Thread对象的join()函数的超时机制，并打印输出join()函数的返回值。

            javascript
            
            
function testFunc() {
    for (var i = 0; i < 5; i++) {
        Log(i)
        Sleep(300)
    }
}

function main() {
    var t1 = threading.Thread(testFunc)
    Log(t1.join(1000))  // undefined
    Log(t1.join())      // {"id":1,"terminated":false,"elapsed":1506864000}
}