Một phần nội dung của tài liệu API (phiên bản python) đã lỗi thời và cần được điều chỉnh để tránh hiểu nhầm.

Tài liệu API (phiên bản python)

Có thể một số người dùng mới quen thuộc với ngôn ngữ là python, không quen thuộc với ngôn ngữ JavaScript.

• 0 python cơ bản ngữ pháp hướng dẫn liên kết

runoob.comPhương pháp ngữ pháp chi tiết có thể được tham khảo tại đây.

• 1 Cấu trúc dữ liệu: Một số cấu trúc dữ liệu thường được sử dụng, được trả về bởi các hàm giao dịch.

  • Record: Tiêu chuẩn từ điển OHLC (Dict), được sử dụng để vẽ các đường K và phân tích các chỉ số, được trả về bởi hàm GetRecords.

{
    'Volume': 153.8109090909091, # 交易量。
    'High'  : 4237.59,       # 最高价。
    'Low'   : 4237.59,       # 最低价。
    'Time'  : 1476892800000, # 这个字典数据的键值，时间间隔是以【毫秒】为单位的。
                             # 引入time模块，time.time()函数返回的时间，间隔是以秒为单位的浮点小数。所以在python语言中时间运算、对比时需要处理。
    'Close' : 4237.59,       # 收盘价。
    'Open'  : 4237.59        # 开盘价。
}

• MarketOrder: Đơn vị độ sâu thị trường, hàm GetDepth () trả về các giá trị của các phím Asks và Bids trong từ điển.

{
    'Price'  : 4237.58,  # 市场深度单 的价格 （订单薄 的某一档的 价格）。
    'Amount' : 15        # 市场深度单 的量  （订单薄 的某一档的量）。
}

• Ticker: Thị trường, dữ liệu từ điển này được trả về bởi chức năng GetTicker ().

{
    'Sell'   : 4237.6,   # 卖一价。
    'Volume' : 100,      # 最近成交量。
    'Buy'    : 4237.58,  # 买一价。
    'Last'   : 4237.59,  # 最后成交价。
    'High'   : 4237.6,   # 最高价。
    'Low'    : 4237.58   # 最低价。
}

• Order: Dữ liệu từ điển đặt hàng, được trả về bởi hàm GetOrder

{
    'Status': 1,         # 订单状态, 参考常量里的订单状态，以下是此键值的常量。
                         # ORDER_STATE_PENDING  :未完成
                         # ORDER_STATE_CLOSED   :已关闭
                         # ORDER_STATE_CANCELED :已取消
                         
    'Amount': 20.0,      # 下单数量。
    'DealAmount': 20.0,  # 成交数量。
    'Price': -1,         # 下单价格，-1 为市价单。
    
    'Type': 0,           # 订单类型, 参考常量里的订单类型，以下是此键值的常量。
                         # ORDER_TYPE_BUY   :买单
                         # ORDER_TYPE_SELL  :卖单

    'Id': 1,             # 交易单唯一标识。
    'AvgPrice': 4237.6   # JS的API文档没有写此项，此键已经更新可用，此键是交易成交均价。
}

• Depth: Độ sâu thị trường, được trả về bởi hàm GetDepth, dữ liệu được trả về là một từ điển, giá trị khóa là danh sách chứa từ điển (MarketOrder)

{
    'Bids': [                                  # 买单列表, 包含MarketOrder字典的列表, 按价格从低向高排序
             {'Price': 4237.58, 'Amount': 15}, 
             {'Price': 4237.57, 'Amount': 15}, 
             {'Price': 4237.56, 'Amount': 15},
             ...
            ], 
    'Asks': [                                  # 卖单列表, 包含MarketOrder字典的列表, 按价格从高向低排序
             {'Price': 4237.6, 'Amount': 15}, 
             {'Price': 4237.61, 'Amount': 15}, 
             {'Price': 4237.62, 'Amount': 15}, 
             ...
            ]
}

• Trade: lấy tất cả lịch sử giao dịch (không phải của chính mình), được trả về bởi chức năng GetTrades.

[
    map[
         Price:4283.16           # 价格
         Time:1.477020122e+12    # 时间(Unix timestamp 毫秒) 
         Type:0                  # 订单类型
         Amount:0.048            # 数量
         Id:5.213554531e+09      # 订单ID （JS API文档没写）
       ] 
    ...
]

Ở đây viết lại, đầu ra in ở trên là thực đĩa Log ra, trước đó Trade là kiểm tra lại Log. Có phải tìm thấy một số sự khác biệt. Trong thông tin thực đĩa Log có một số map, chúng đại diện cho sau [] là từ điển, không có map là danh sách.

• Fee: cấu trúc phí giao dịch, được trả về bởi hàm GetFee (ví dụ như giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch giao dịch

{
    'Sell': 0.03,  # 卖出手续费, 为一个浮点数, 如0.2表示0.2%的手续费
    'Buy': 0.03    # 买入手续费, 格式同上
}

• Account: Thông tin tài khoản, được trả về bởi hàm GetAccount

{
    'Balance': 10000.0,    # 余额(人民币或者美元, 在Poloniex交易所里BTC_ETC这样的品种, Balance就指的是BTC的数量, 
                           # Stocks指的是ETC数量, BTC38的ETC_BTC相当于Poloniex的BTC_ETC, 指的是以BTC计价)
    
    'Stocks': 3.0,         # BTC/LTC数量, 现货为当前可操作币的余额(去掉冻结的币), 
                           # 期货的话为合约当前可用保证金(传统期货为此属性)
                           
    'FrozenBalance': 0.0,  # 冻结的余额
    'FrozenStocks': 0.0    # 冻结的BTC/LTC数量(传统期货无此属性)
}

• Chức năng giao dịch: giao dịch được lưu trữ trên một sàn giao dịch hoặc trên một sàn giao dịch như các chức năng mà bạn sở hữu (tài liệu dưới đây được kiểm tra trong kiểm tra lại)

  • GetName: Trả lại tên giao dịch (string)

exchange.GetName()  # 测试的交易所是OKCoin，用Log 函数输出 Log(exchange.GetName()),  显示为 ： OKCoin

• GetLabel: Trả lại thẻ tùy chỉnh của sàn giao dịch (string)

exchange.GetLabel() # 在添加交易所的时候，可以设置标签，用来区别同一个交易所的不同账户，比如标签设置为OKCoin1、OKCoin2

• GetUSDCNY: Trả về tỷ giá đô la được sử dụng trên sàn giao dịch, OKCoin tương lai trả về tỷ giá chính thức được cung cấp (float>), không bị ảnh hưởng bởi SetRate

Log(exchange.GetUSDCNY(),type(exchange.GetUSDCNY())) # 交易所为OKCoin ,输出显示 6.7294 <type 'float'>

• GetRate: Trả về tỷ lệ hối đoái giữa đồng tiền lưu hành và đồng nhân dân tệ được sử dụng trên sàn giao dịch, ngoại hối là USD/EUR so với CNY

# 汇率接口调用雅虎提供的接口, 5分钟更新一次
# 所有函数自动经过汇率转换,在脚本层,自动都转换为人民币,下单也是用人民币价格,不管内盘外盘
Log(exchange.GetRate()) # 交易所为OKCoin期货  输出显示6.7294

• SetRate: Lập tỷ giá giữa đồng tiền lưu hành trên sàn giao dịch và đồng nhân dân tệ, ngoại tệ là USD/EUR so với CNY, trả lại tỷ giá trước khi thiết lập

比如OKCoin期货设置SetRate(6.13), 就是设定USD/EUR对CNY的汇率为6.13, 程序所有价格会自动用这个汇率计算
SetRate(), 如果不加参数，则恢复系统内置汇率
exchange.SetRate(6.13)    #  交易所为OKCoin期货 
Log(exchange.GetRate())   #  6.13
exchange.SetRate()
Log(exchange.GetRate())   #  6.7294

• GetCurrency: trả lại tên của tiền tệ mà sàn giao dịch vận hành (string), CTP tương lai truyền thống trả lại cố định là STOCK

Log(exchange.GetCurrency())   # 交易所为OKCoin期货，标的物 BTC， 函数返回字符串，输出 BTC

• GetTicker: Trở lại một từ điển Ticker, chi tiết về cấu trúc tài liệu - dữ liệu

Log(exchange.GetTicker())  #  返回 行情数据
                             #  {'Sell': 4259.98, 'Volume': 100, 'Buy': 4259.96, 'Last': 4259.97, 'High': 4259.98, 'Low': 4259.96}

• GetDepth: Trở lại một từ điển Depth

Log(exchange.GetDepth())  # 返回 市场深度数据（订单薄）如下
{
    'Bids': [{'Price': 4259.96, 'Amount': 15}, {'Price': 4259.95, 'Amount': 15}], ...  #买单列表：买一、买二
    'Asks': [{'Price': 4259.98, 'Amount': 15}, {'Price': 4259.99, 'Amount': 15}], ...  #卖单列表：卖一、卖二
}

• GetTrades: Trả về một danh sách chứa từ điển Trade, theo thứ tự thời gian từ thấp đến cao, chỉ hỗ trợ tiền kỹ thuật số ((BTC/LTC))

Log("GetTrades()函数 返回：", exchange.GetTrades())  # 回测不支持此函数，以下实盘测试
                                                  # GetTrades()函数 返回： 
[map[Price:4295.43 Time:1.47710627e+12 Type:1 Amount:0.02 Id:5.222046713e+09] 
 map[Price:4295.42 Time:1.47710627e+12 Type:1 Amount:0.23 Id:5.222046715e+09] 
 map[Price:4295.49 Time:1.477106271e+12 Type:0 Amount:0.01 Id:5.222046763e+09]
 ...
 ]

• GetRecords ((Period): Trả về một lịch sử K-line, K-line cycle được chỉ định khi bot được tạo, chứa danh sách từ điển Record

# 不加参数, 默认返回添加机器人时时指量的K线周期, 但也可以自定义K线周期
# 支持: PERIOD_M1 指1分钟, PERIOD_M5 指5分钟, PERIOD_M15 指15分钟, PERIOD_M30 指30分钟, PERIOD_H1 指1小时, PERIOD_D1 指一天
Log(exchange.GetRecords()) # 获取K线数据，并输出显示。
[{'Volume': 8637.650000000,'High': 4259.0,'Low': 4257.56,'Time': 1476964200000,'Close': 4258.85,'Open': 4257.6},# 第一根K线bar
 {'Volume': 14325.999999999,'High': 4258.95,'Low': 4256.0,'Time': 1476964500000,'Close': 4256.25,'Open': 4258.87},# 第二根K线bar
 ...
 {'Volume': 1339.070000000, 'High': 4258.38, 'Low': 4257.0, 'Time': 1476967200000, 'Close': 4258.12, 'Open': 4257.0} 
 # 最后一根（最新）K线bar。（这一根的数据除了Time 键值，其它的都是时刻变化的，只有这个周期完成数据才确定。）
 ]

• GetAccount: Trả về một từ điển Account, chẳng hạn như exchange.GetAccount ((), sẽ trả về thông tin tài khoản của sàn giao dịch chính

Log(exchanges[0].GetName(), exchanges[0].GetAccount())
Log(exchanges[1].GetName(), exchanges[1].GetAccount())
# exchange 和 exchanges[0] 都代表策略第一个添加的交易所（主交易所）
# 输出显示： 
# OKCoin {'Balance': 10000.0, 'Stocks': 3.0, 'FrozenBalance': 0.0, 'FrozenStocks': 0.0} 
# Huobi {'Balance': 10000.0, 'Stocks': 3.0, 'FrozenBalance': 0.0, 'FrozenStocks': 0.0}

• Buy ((Price, Amount): mua tiếp theo, Price là giá mua, Amount là số lượng, trả về một ID đặt hàng

可以跟多余的参数做为附加消息显示到日志, 如exchange.Buy(1000,0.1, "OK", 123)
支持现货(火币/BitVC/OKCoin/OKCoin国际/OKCoin期货)市价单, 市价单价格指定为-1
id1 = exchange.Buy(4300,1)     # 日期                  平台    类型  价格     数量   信息
                                   # 2016-10-21 00:00:00  OKCoin  买入  4300     1
id2 = exchange.Buy(-1, 8000)   # 市价单 的第二个参数的意义是  购买8000金额的 币数。

• Sell (Price, Amount): Các phương thức và trường hợp gọi giống như Buy

id1 = exchange.Sell(4300,1) #     日期                     平台        类型      价格      数量     信息
                                #     2016-10-21 00:00:00     OKCoin      卖出      市价单     1	
id2 = exchange.Sell(-1, 1)  #     日期                     平台        类型      价格      数量     信息
                                #     2016-10-21 00:00:00     OKCoin      卖出      4300      1
                            # 一般错误提示： 小于允许的最小交易单位，大部分是这个原因（参数1是1块钱而不是1个币）。

• GetOrders: lấy tất cả các đơn đặt hàng chưa hoàn thành và trả về một danh sách từ điển Order

# 区别于 GetOrder 函数，该函数不加参数，返回一个列表。
id1 = exchange.Sell(4500,1)
id2 = exchange.Buy(2300, 1)
Log(exchange.GetOrders())
# Log输出以下信息(状态是未成交)
[{'Status': 0, 'Amount': 1.0, 'DealAmount': 0.0, 'Price': 4500.0, 'Type': 1, 'Id': 1, 'AvgPrice': 0.0}, 
{'Status': 0, 'Amount': 1.0, 'DealAmount': 0.0, 'Price': 2300.0, 'Type': 0, 'Id': 2, 'AvgPrice': 0.0}]

• GetOrder ((orderId): lấy chi tiết đơn đặt hàng theo số đơn đặt hàng, trả về một từ điển Order

id1 = exchange.Sell(4500,1)
Log(exchange.GetOrder(id1))
# {'Status': 0, 'Amount': 1.0, 'DealAmount': 0.0, 'Price': 4500.0, 'Type': 1, 'Id': 1, 'AvgPrice': 0.0}

• CancelOrder ((orderId): hủy một đơn đặt hàng dựa trên số đơn đặt hàng, trả về true hoặc false

根据Buy 、Sell 函数返回的 订单id , 或者 Order字典 中的id 键值， 取消指定id 的订单。 可以扩展代码循环调用，用来取消所有未完成的挂单。

• GetMinStock: Số lượng giao dịch tối thiểu

回测和实盘精度有区别，可以自行测试一下。

• GetMinPrice: trả lại số tiền tối thiểu yêu cầu cho một đơn đặt hàng ((giá * số lượng)

Bitstamp要求5美元(程序会根据汇率自动转换为人民币), 其它没有限制

• GetFee: Trở lại một từ điển Fee

Log(exchange.GetFee())  # OKCoin 实盘测试 map[Sell:0 Buy:0]

• GetRawJSON: Trả về nội dung gốc (string) được trả về từ lần yêu cầu REST API cuối cùng mà người dùng có thể tự phân tích và mở rộng thông tin

# 注: 模拟测试的话，会一直返回一个空字符串, 只在真实环境下有效
ticker = exchange.GetTicker()
Log("GetRawJSON:", exchange.GetRawJSON())
Log("type(json1)", type(json1))
# OKCoin 实盘 输出 GetRawJSON: 
# {"date":"1477130308","ticker":{"buy":"4337.33","high":"4345.97","last":"4337.32","low":"4280.0",
# "sell":"4337.38","vol":"1164227.77"}}
# type(json1) <type 'str'>

• Go ((Method, Args...): Hỗ trợ chức năng không đồng bộ nhiều chuỗi, có thể biến các hoạt động của tất cả các chức năng được hỗ trợ thành không đồng bộ. (Chỉ hỗ trợ cryptocurrency BTC/LTC)

Support: GetTicker, GetDepth, GetTrades, GetRecords, GetAccount, GetOrders, GetOrder, CancelOrder, Buy, Sell, GetPosition
# Python与Javascript的区别, Python的wait返回两个参数, 第一个是异步的api返回的结果, 第二个表示是异步调用是否完成
ret, ok = d.wait() # ok是一定返回True的, 除非策略被停止
ret, ok = d.wait(100) # ok返回False, 如果等待超时, 或者wait了一个已经结束的实例

• IO (api, ApiName, Args): Gọi giao diện chức năng khác của sàn giao dịch

exchange.IO("api", "cancel_borrow", "symbol=cny&borrow_id=123"); # no need api & sign
ret = exchange.IO("websocket")
Log("is Open websocket mode:", ret)
# OKCoin 实盘 输出： is Open websocket mode: websocket

• Chức năng toàn cầu: Một số chức năng mở rộng được cung cấp bởi hệ thống, ((được xây dựng _C, _N, _G)

  • Version: Trả về phiên bản hiện tại của hệ thống, giá trị chuỗi, ví dụ 3.0

Log("当前的托管者版本为:" ,Version())
# 回测使用 云端服务器 ，输出：  当前的托管者版本为: 3.1

• Log: lưu tin nhắn vào danh sách nhật ký

i = 1
Bool = False
string = "hello world!"
Dict = {"name": "jack", "age": 18}
List = [Dict, "I love python!"] 
Log("输出信息，可以加多个参数。参数可以是各种类型。", "--Dict:", Dict,"--List:", 
        List, "--Number:", i, "--String:", string, "--Bool:", Bool)   
# 输出:可以加多个参数。参数可以是各种类型。 
# --Dict: {'age': 18, 'name': 'jack'} --List: [{'age': 18, 'name': 'jack'}, 'I love python!'] 
#       --Number: 1 --String: hello world! --Bool: False

• Sleep ((Millisecond): Chức năng ngủ

参数为毫秒数,如Sleep(1000)为休眠一秒, 该函数在回测时根据参数大小会影响回测速度， 大小一般为500 或者 1000 。

• LogProfit ((Profit): ghi lại mức lợi nhuận, đây là giá trị của tổng lợi nhuận, kiểu tham số là số điểm nổi

def main():
    i = 0 # 定义一个int 型变量，控制循环次数
    while i < 10: # 循环体， i 小于 10 为 True 时执行循环，为False 了跳出循环。
        i += 1    # 每次i 值自己加1 ， i += 1 即： i = i + 1 
        LogProfit(i) # 在日志中输出 盈利数值，  并且在收益图表上显示出来。
        Sleep(1000)
        # 显示如下图

• LogProfitReset: Dọn sạch tất cả các nhật ký lợi nhuận, có thể dùng một số tham số để chỉ mục được lưu

def main():
    i = 0
    LogProfitReset(5) # 在开始调用，用于清除上次执行后的收益图表，参数为5 表示保留上次最后5个收益数据。
    while i < 10:
        i += 1
        LogProfit(i)
        Sleep(1000)
# 使用OKCoin 实盘测试， 第一次启动策略显示 输出了10个收益日志信息，图表也显示了10个点的收益曲线。
# 第二次启动策略同样显示了10个收益日志信息（日志信息并没有清除。），图表上的数据保留了之前的最后5条（需要刷新下）。

• LogReset: Dọn sạch tất cả các nhật ký, có thể dùng một số tham số để xác định mục lưu trữ

# 该函数只清除日志信息，（需要刷新下才能看出来），在加参数时如果希望保留之前的N条日志的话，参数需要写N+1，
# 因为策略开始运行第一条语句前会输出一条启动日志，所以需要多保留一条（参数加1，即N+1）。图表没有变化。

• LogStatus ((Msg): thông tin này không được lưu trong danh sách nhật ký, chỉ cập nhật thông tin trạng thái của robot hiện tại, hiển thị ở phía trên nhật ký, có thể được gọi nhiều lần, cập nhật trạng thái

    LogStatus('这是一个普通的状态提示')
    LogStatus('这是一个红色字体的状态提示 #ff0000')
    LogStatus('这是一个多行的状态信息\n我是第二行')
    
    LogStatus("`data:image/png;base64,AAAA`")
    # LogStatus支持打印base64编码后的图片, 以"`"开头, 以"`"结尾, 如LogStatus("`data:image/png;base64,AAAA`")
    # 网上有转换工具，比如这个网站： http://tool.css-js.com/base64.html  。
    # 选择图片转换后的代码直接替换掉 LogStatus("`data:image/png;base64,AAAA`")中的 `data:image/png;base64,AAAA` 就可以了。
    
    table = {"type":'table',"title":'持仓信息',"cols": ['列1', '列2'],"rows":[ ['abc', 'def'],['ABC', 'support color #ff0000']]};
    LogStatus('`' + json.dumps(table)+'`'); # 需要 import json 模块
    
    table = {"type":'table',"title":'持仓信息',"cols": ['列1', '列2'],"rows":[ ['abc', 'def'],['ABC', 'support color #ff0000']]};
    LogStatus('第一行消息\n`' + json.dumps(table)+'`\n第三行消息'); # 表格信息也可以在多行中出现
    
    table = {"type":'table',"title":'持仓信息',"cols": ['列1', '列2'],"rows":[ ['abc', 'def'],['ABC', 'support color #ff0000']]};
    LogStatus('`' + json.dumps([table, table])+'`'); # 支持多个表格同时显示, 将以TAB显示到一组里
    # json.dumps方法对简单数据类型encoding（转为JSON），json.loads方法处理简单数据类型的decoding（转为python对象）

• EnableLog ((IsEnable): mở hoặc tắt các bản ghi nhật ký của các thanh định dạng và thanh thông tin sai

# 参数是布尔值： False  、 True  （区别于 JavaScript 的 false 、 true）。

• Chart (({...}): Chart Chart

import json
chart = {
    '__isStock': True,
    'title': {
        'text': '测试API ：Chart({...}) '
    },
    'yAxis': {
        'plotLines': [{
            'value': 4520,
            'color': 'red',
            'width': 2,
            'label': {
                'text': 'line1',
                'align': 'center'
            },
        }, {
            'value': 4500,
            'color': 'green',
            'width': 2,
            'label': {
                'text': 'line2',
                'align': 'center'
            },
        }]
    },
    'series': [{
        'type': 'candlestick',
        'name': '当前周期',
        'id': 'primary',
        'data': []
    }]
}
def main():
    global chart  # 记得 引用全局
    records = _C(exchange.GetRecords) # 获取 K线数据
    obj_chart = Chart(chart) # 创建 图表对象
    obj_chart.reset() # 清空
    for i in range(len(records)): #  遍历 Dict records 
        b = records[i] #  间接一下，少些点代码
        obj_chart.add(0,[b['Time'], b['Open'], b['High'], b['Low'], b['Close']]) # 向图表中写入 K线数据
    obj_chart.update(chart)   # 更新图表，  记得调用 API :  update 的时候传入 JSON 图表结构（这里是chart）
    
    # 1、参数为可以JSON序列化的HighStocks的Highcharts.StockChart参数, 比原生的参数增加一个__isStock属性, 
    #    如果指定__isStock: false, 则显示为普通图表
    # 2、返回对像可以调用add([series索引(如0), 数据])向指定索引的series添加数据, 调用reset()清空图表数据, 
    #    reset可以带一个数字参数, 指定保留的条数
    # 3、可以调用add([series索引(如0), 数据, 此数据在series中的索引])来更改数据
    #    可以为负数, -1指最后一个, -2是倒数第二个, 如:chart.add([0, 13.5, -1]), 更改series[0].data的倒数第一个点的数据
    # 4、记得调用 chart.update({...})  参数即 全局变量 字典chart
    #    HighStocks: http://api.highcharts.com/highstock ，  实际运行效果下图。

• Mail ((...): chức năng gửi thư

Mail(smtpServer, smtpUsername, smtpPassword, mailTo, title, body); ret true or false
Mail("smtp.163.com", "asdf@163.com", "password", "111@163.com", "title", "body")
# 平台API Mail()函数的使用详解 链接：https://www.fmz.com/bbs-topic/310

• SetErrorFilter ((RegEx) lọc thông tin lỗi

# 被此正则表达式匹配的错误将不上传到日志系统, 可多次调用设置多个
SetErrorFilter("502:|503:|tcp|character|unexpected|network|timeout|WSARecv|Connect|GetAddr|
no such|reset|http|received|EOF|reused")

• GetPid: Trả lại ID quy trình của robot

Log(GetPid())   

• GetCommand: lấy lệnh tương tác (utf-8)

# 获取策略交互界面发来的命令并清空, 没有命令则返回null, 返回的命令格式为 "按钮名称:参数", 如果没有参数, 则命令就是按钮名称
while 1:
    cmd = GetCommand()
    if cmd:
        Log(cmd)
    Sleep(1000)

• _G(K, V): danh sách từ điển toàn cầu có thể lưu

def main(): 
    # KV表, 永久保存在本地文件, 每个机器人单独一个数据库, 重启或者托管者退出后一直存在
    # K必须为数字或者字符串, 不区分大小写, V可以为任何可以JSON序列化的内容
    _G("num", 1)  # 设置一个全局变量num, 值为1
    Log("_G 取得num 值：", _G("num"))
    _G("num", "ok")  # 更改一个全局变量num, 值为字符串ok
    Log("_G 取得num 值：", _G("num"))
    _G("num", null)  # 删除全局变量 num
    _G("num2", "false")
    Log("_G 取得num 值：", _G("num"), "_G 取得num2 值：", _G("num2"))
    _G()  # 返回当前机器人的ID
    _G(null)  # 删除所有全局变量
    Log("_G 取得num 值：", _G("num"), "_G 取得num2 值：", _G("num2"))

• _C ((): hàm này chủ yếu được sử dụng cho API lỗi, ví dụ như hàm exchange.GetAccount ((), được gọi như sau: _C ((exchange.GetAccount); hãy lưu ý rằng tên hàm không được đặt dấu ngoặc, nếu hàm lỗi cần thêm tham số thì sẽ được viết ở tham số thứ hai của hàm _C ((), lần lượt về sau.

def main(): 
    amount = 1
    price = 2000
    Log("使用_C 函数:", _C(exchange.GetAccount))
    _C(exchange.Buy, price, amount)

• _N(): Chức năng này được sử dụng để xử lý quá nhiều vị trí sau điểm số nhỏ, giữ lại một số vị trí nhỏ.

def main(): 
    pi = 3.1415926535897
    Log("使用_N函数前pi:", pi)
    
    piOfDeal = _N(pi, 2)
    Log("使用_N函数后pi:", piOfDeal)

• những người khácMột, chỉ hỗ trợ chế độ Websocket (huobi).okcoin.cn, BTCC hỗ trợ) và giao dịch tương lai hàng hóa CTPexchange.IO("websocket")Chuyển giao thức giao tiếp thị trường sang websocket (bên mặc định là rest), Ticker, Depth sẽ chuyển sang giao thức websocket để cập nhật, CTP tương lai hàng hóa không cần chuyển đổi Chuyển đổi chế độ cập nhật dữ liệu GetTicker, GetDepth

  2、exchange.IO("mode", 0)Chế độ quay trở lại ngay lập tức, nếu hiện chưa nhận được dữ liệu thị trường mới nhất của sàn giao dịch, sẽ quay trở lại dữ liệu thị trường cũ ngay lập tức, nếu có dữ liệu mới, sẽ quay trở lại dữ liệu mới

  3、exchange.IO("mode", 1)Chế độ lưu trữ (chế độ mặc định), nếu hiện tại chưa nhận được dữ liệu thị trường mới nhất của sàn giao dịch (so sánh với dữ liệu thu thập trước đây của API), Nó sẽ chờ đợi để nhận và sau đó quay lại, nếu bạn nhận được dữ liệu thị trường mới nhất trước khi gọi chức năng, nó sẽ quay lại dữ liệu mới nhất ngay lập tức.

  4、exchange.IO("mode", 2)Chế độ cập nhật bắt buộc, vào chờ cho đến khi nhận được dữ liệu đẩy mới nhất cho sàn giao dịch tiếp theo và quay trở lại

  5, nếu bạn muốn lần đầu tiên có được thị trường mới nhất có thể chuyển sang websocket sau đó không ngủ ngay lập tức phát hiện dữ liệu, GetTicker, GetDepth làm việc theo chế độ lưu trữ

  exchange.IO("websocket")
  while 1:
      Log(exchange.GetTicker())
  

  6, mỗi chuỗi tin nhắn có thể kết thúc bằng giá trị RGB như "#ff0000", đại diện cho màu cảnh trước cần hiển thị, nếu là định dạng như #ff0000112233, thì sau đó là màu nền.

• Giao dịch tương lai: tương lai hỗ trợ giao thức tương lai hàng hóa truyền thống CTP, tương lai BTC: 796, BitVC, OKCoin

  • Position Dictionary: Thông tin về vị trí nắm giữ trong giao dịch tương lai, được trả về từ hàm GetPosition (())

{
        "MarginLevel":    # 杆杠大小, 796期货有可能为5, 10, 20三个参数, OKCoin为10或者20, 
                          # BitVC期货和OK期货的全仓模式返回为固定的10, 因为原生API不支持
                      
        "Amount":         # 持仓量, 796期货表示持币的数量, BitVC指持仓的总金额(100的倍数), 
                          # OKCoin表示合约的份数(整数且大于1)
                      
        "CanCover":       # 可平量, 只有股票有此选项, 表示可以平仓的数量(股票为T+1)今日仓不能平
    
        "FrozenAmount":   # 冻结量, 支持传统期货与股票, 数字货币只支持796交易所
    
        "Price":          # 持仓均价
    
        "Profit":         # 持仓浮动盈亏(数据货币单位：BTC/LTC, 传统期货单位:RMB, 股票不支持此字段, 
                          # 注: OKCoin期货全仓情况下指实现盈余, 并非持仓盈亏, 逐仓下指持仓盈亏)
                      
        "Type":           # PD_LONG为多头仓位(CTP中用closebuy_today平仓), 
                          # PD_SHORT为空头仓位(CTP用closesell_today)平仓, 
                          # (CTP期货中)PD_LONG_YD为咋日多头仓位(用closebuy平),
                          # PD_SHORT_YD为咋日空头仓位(用closesell平)
                      
        "ContractType":   # 商品期货为合约代码, 股票为'交易所代码_股票代码', 具体参数SetContractType的传入类型
}

• GetPosition: Nhận thông tin hiện tại

# 返回一个Position数组, (BitVC和OKCoin)可以传入一个参数, 指定要获取的合约类型
    def main(): 
        exchange.SetContractType("MA701")
        ticker1 = exchange.GetTicker()
        exchange.SetDirection("buy")
        exchange.Buy(ticker1['Sell'] + 1, 1, "MA701")
        exchange.SetDirection("sell")
        exchange.Sell(ticker1['Buy'] - 1, 2, "MA701")
        exchange.SetContractType("CF701")
        exchange.SetDirection("buy")
        ticker2 = exchange.GetTicker()
        exchange.Buy(ticker2['Sell'] + 1, 4, "CF701")
        positions = exchange.GetPosition()     # GetPosition() 函数返回的是 一个列表。
        Log("positions:", positions)    #  输出这个列表
        for i in range(len(positions)):  #  遍历
            Log(positions[i])

• SetMarginLevel (MarginLevel): Thiết lập kích thước thanh

# 设置Buy(多单)或者Sell(空单)的杆杠大小, MarginLevel有5, 10, 20 三个可选参数
# 796支持5,10,20,50三个选项, BitVC的LTC不支持20倍杠杆, OKCoin支持10倍和20倍
# 如: exchange.SetMarginLevel(5)

• SetDirection ((Direction): thiết lập loại mục mua hoặc bán

# Direction可以取buy, closebuy, sell, closesell四个参数, 传统期货多出closebuy_today,与closesell_today, 
# 指平今仓, 默认为closebuy/closesell为平咋仓
# 对于CTP传统期货, 可以设置第二个参数"1"或者"2"或者"3", 分别指"投机", "套利", "套保", 不设置默认为投机
# 股票只支持buy与closebuy, 因为股票只能买跟平仓
exchange.SetMarginLevel(5)
exchange.SetDirection("buy")
exchange.Buy(1000, 2)
exchange.SetMarginLevel(5)
exchange.SetDirection("closebuy")
exchange.Sell(1000, 2)

• SetContractType (ContractType): đặt loại hợp đồng

# 传统的CTP期货的ContractType就是指的合约ID,  如SetContractType("au1506") 返回合约的详细信息, 
# 如最少一次买多少, 手续费, 交割时间等
# 股票合约格式为 股票代码.(SH/SZ), SH指上交所, SZ指深交所, 如000001.SZ就是指深交所的平安银行
# 商品期货与股票取消订阅合约, 在合约名前加上"-"前缀重新调用即可, 如SetContractType("-au1506"); 成功返回true
# 数字货币796支持: "week", "weekcny", 默认为子账户A, 要指定子账户是A还是B, 在合约后加"@A"或"@B", 
# 如: "day@A" 为日合约A子账户
# BitVC有week和quarter和next_week三个可选参数, OKCoin期货有this_week, next_week, quarter三个参数
exchange.SetContractType("week");

Các chi tiết khác về hợp đồng tương lai hàng hóa:https://www.fmz.com/api

• Các hàm chỉ số: TA - tối ưu hóa phần viết lại thư viện các hàm chỉ số phổ biến, talib -http://ta-lib.org/

  • TA - Tối ưu hóa phần viết lại của thư viện các chỉ số phổ biến

MACD                  # 指数平滑异同平均线
KDJ                   # 随机指标
RSI                   # 强弱指标
ATR                   # 平均真实波幅
OBV                   # 能量潮
MA                    # 移动平均线
EMA                   # 指数平均数指标
BOLL                  # 布林带
Alligator             # Alligator Indicator
CMF                   # 蔡金货币流量指标
Highest               # 周期最高价
Lowest                # 周期最低价

• talib -http://ta-lib.org/

help       #查询指标调用格式
ACOS       #Vector Trigonometric ACos
AD         #Chaikin A/D Line
ADOSC      #Chaikin A/D Oscillator
ADX        #Average Directional Movement Index
ADXR       #Average Directional Movement Index Rating
APO        #Absolute Price Oscillator
AROON      #Aroon
AROONOSC   #Aroon Oscillator
...

https://www.fmz.com/api

Thêm nữa