语法指南 | 发明者量化

exchange.Log

在日志栏区域输出下单、撤单日志。该函数被调用时不会实际下单，仅用于输出并记录交易日志。


    
    
    
exchange.Log(orderType, price, amount)


    
    
    
exchange.Log(orderType, price, amount, ...args)

示例

使用exchange.Log(orderType, price, amount)可以进行实盘跟单测试、模拟下单，也可以辅助记录下单信息。

最常见的使用场景为：通过exchange.IO函数访问交易所的创建条件订单接口，但调用exchange.IO()函数并不会在实盘日志中输出交易日志信息。

此时即可使用exchange.Log()函数补充输出日志，以便记录下单信息，撤单操作亦是如此。


    javascript
    
    
var id = 123
function main() {
    // 下单类型买入，价格999，数量 0.1
    exchange.Log(LOG_TYPE_BUY, 999, 0.1)
    // 取消订单
    exchange.Log(LOG_TYPE_CANCEL, id)
}


    python
    
    
id = 123
def main():
    exchange.Log(LOG_TYPE_BUY, 999, 0.1)
    exchange.Log(LOG_TYPE_CANCEL, id)


    rust
    
    
fn main() {
    let id = 123;
    // 下单类型买入，价格999，数量 0.1
    exchange.Log(LOG_TYPE_BUY, 999, 0.1);
    // 取消订单，orderType为LOG_TYPE_CANCEL时price参数为撤单的订单Id（Rust中amount参数必传，可传0）
    exchange.Log(LOG_TYPE_CANCEL, id, 0);
}

返回值

类型	描述
string / bool	`orderType`为`LOG_TYPE_BUY`、`LOG_TYPE_SELL`时返回一个虚拟订单号字符串，格式为`V`加5位递增序号，例如`V00001`；`orderType`为`LOG_TYPE_CANCEL`时`JavaScript`、`Python`返回`true`，`Rust`返回空字符串。

参数

名称	类型	必填	描述
orderType	number	是	输出的日志类型，可选值为`LOG_TYPE_BUY`、`LOG_TYPE_SELL`、`LOG_TYPE_CANCEL`。
price	number	是	日志中显示的价格。
amount	number	是	日志中显示的下单量。
arg	string / number / bool / object / array / any	否	扩展参数，用于向该条日志中输出附带信息，`arg`参数可以传入多个。

参考

Log exchange LOG_TYPE_BUY LOG_TYPE_SELL LOG_TYPE_CANCEL

备注

当orderType参数为LOG_TYPE_CANCEL时，price参数表示撤单的订单Id，用于在直接调用exchange.IO()函数撤单时打印撤单日志。

exchange.Log()函数是exchange交易所对象的成员函数，区别于全局函数Log。