Einführung

Hallo zusammen, ich bin „Oak Quantitative“. Aufgrund der Markttrenderinnerung, die ich vor einiger Zeit entwickelt habe [Überwachung des Dashboards】 wird von allen sehr geliebt und es gibt gleichzeitige Erinnerungen vom gleichnamigen Servicekonto [Oak Quantitative], das neuen und alten Investoren eine neue Referenz für die Beurteilung von Markttrends bietet. Wir haben diese Popularität ausgenutzt und damit begonnen, eine Verbindung zur erweiterten API von FMZ herzustellen, um die Nachrichtenkommunikation zwischen Robotern zu ermöglichen und Marktwarnungen direkt an bestimmte Roboter zu senden. Dieser Artikel enthält zwei Anwendungsszenarien als Beispiele, um die Diskussion anzuregen. Ich hoffe, Sie können noch mehr interessante Dinge entwickeln …

Dieser Artikel stellt hauptsächlich vor: 1. Wie stellen Entwickler über die JS-Sprache eine Verbindung zur erweiterten API von FMZ her? (Dieser Artikel verwendet die Methode GetNodeList als Beispiel) 2. Fall 1: Verwenden Sie die CommandRobot-Methode der erweiterten API, um die Nachrichtenkommunikation zwischen dem Überwachungsroboter und anderen Robotern zu implementieren. 3. Fall 2: Verwenden Sie die Methode GetRobotDetail der erweiterten API, um eine einheitliche Überwachung und Anzeige mehrerer Roboterdaten zu erreichen.

1. Verwenden Sie JS, um eine Verbindung zur erweiterten API von FMZ herzustellen

1. AccessKey und SecretKey (nachfolgend AK und SK genannt) beantragen. Wir bewerben uns im Menü [Kontoeinstellungen] -> [API-Schnittstelle] -> [Neuen API-Schlüssel erstellen] auf der offiziellen FMZ-Website, erhalten dann einen Satz von AK und SK und zeichnen sie auf. (FMZs AK und SK sind nicht wie Börsen, wo sie nur beim ersten Erstellen sichtbar sind. In FMZ können wir die vollständigen Daten unserer AK und SK jederzeit im Menü [API-Schnittstelle] anzeigen.)

2. Entwickeln Sie gemäß der Dokumentation der erweiterten API Schauen wir uns zunächst die wichtigsten Schritte zum Anfordern der API an

3. FMZ API-Schnittstelle:

https://www.fmz.com/api/v1

1. Grundlegende Parameter anfordern

{
    'version'   : '1.0',                                //自定义版本号
    'access_key': '8a148320e0bxxxxxxxxxxxxxx19js99f',   //AK
    'method'    : 'GetNodeList',                        //具体调用的方法
    'args'      : [],                                   //具体method算法的参数列表
    'nonce'     : 1516292399361,                        //时间戳，单位毫秒
    'sign'      : '085b63456c93hfb243a757366600f9c2'    //签名（需要根据上面5个参数加密获取，下面有讲）
}

1. Die komplette Anfrage-URL wird in Form von Fragezeichen-Parameterübergabe aneinandergereiht

以GetNodeList方法为例
https://www.fmz.com/api/v1?
access_key=8a148320e0bxxxxxxxxxxxxxx19js99f&
nonce=1516292399361&
args=%5B%5D&
sign=085b63456c93hfb243a757366600f9c2&
version=1.0&
method=GetNodeList

1. Signaturverfahren

按照如下顺序进行参数拼接后，使用MD5加密算法加密字符串，并转换为十六进制数据字符串值，该值作为参数sign的值。
version + "|" + method + "|" + args + "|" + nonce + "|" + secretKey

1. Zusammenfassend gibt es folgende Codes Quellcode-Adresse:[Oak Quantitative]-JS Docking FMZ Erweiterung API Demo

var URL = "https://www.fmz.com/api/v1?";
var AK = "b3a53d3XXXXXXXXXXXXXXXXXXX866fe5";//这里替换成你自己的AccessKey
var SK = "1d9ddd7XXXXXXXXXXXXXXXXXXX85be17";//这里替换成你自己的SecretKey

function main() {
    //获取5个基础参数对象
    var param = getParam("1.0.0",AK,getArgs());
    Log("param:",param);
    //获取拼接参数md5加密后的结果
    var md5Result = md5(param);
    //赋值加密结果到基础参数对象中
    param.sign = md5Result;
    //获取请求api的URL
    var finalUrl = getFinalUrl(param);
    Log("finalUrl:",finalUrl);
    //执行请求并打印结果
    var info = HttpQuery(finalUrl);
    Log("info:",info);
}

//获取基础5个参数的对象
function getParam(version,ak,args){
    return {
        'version': version,
        'access_key': ak,
        'method': 'GetNodeList',
        'args': JSON.stringify(args),
        'nonce': new Date().getTime()
    }
}

//执行md5加密
function md5(param){
    var paramUrl = param.version+"|"+param.method+"|"+param.args+"|"+param.nonce+"|"+SK
    Log("paramUrl:",paramUrl);
    return Hash("md5", "hex", paramUrl)
}

//获取最终请求URL
function getFinalUrl(param){
    return URL+"access_key="+AK+"&nonce="+param.nonce+"&args="+param.args+"&sign="+param.sign+"&version="+param.version+"&method="+param.method;
}

//js中不支持...args的命名方式，所以改用arguments关键字获取参数数组
function getArgs(){
    return [].slice.call(arguments);
}

Fall 2: Verwenden der CommandRobot-Methode der erweiterten API zur Implementierung der Nachrichtenkommunikation zwischen Robotern

Basierend auf dem obigen Code verwenden wir die CommandRobot-Methode, um die Nachrichtenkommunikation zwischen Robotern zu implementieren.

Sehen wir uns zunächst die beiden Parameter an, die von der Methode CommandRobot(RobotId, Cmd) benötigt werden.

Nachdem wir die Bedeutung der Parameter kennen, implementieren wir als Nächstes diese Aufrufmethode.

1. Holen Sie sich die Roboter-ID auf der Roboterdetailseite:

2. Implementieren Sie die Methode zum Abrufen der Cmd-Nachricht

//获取消息头信息
function getMessageBody(toUserName,msgType,content){
    return ({
        "toUserName":toUserName,//发送给谁
        "fromUserName":AOKE_INFO,//消息来源
        "createTime": new Date().getTime(),//当前时间戳
        "msgType":msgType,//消息类型
        "content":content,//消息内容
        "msgId":Math.random().toString(36).slice(-8)//消息ID
    })
}

//获取消息体趋势信息（消息头content字段的数据）
function getCtaDate(symbol,timeCycle,direction,nowCycleTime){
    return {
        "symbol":symbol,//交易币种
        "timeCycle":timeCycle,//趋势周期
        "direction":direction,//当前进入的方向，0:看空，1:看多
        "createTime":new Date().getTime(),//当前时间戳
        "nowCycleTime":nowCycleTime//当前进入的周期起始时间
    }
}

1. Ändern Sie den Code zum Senden von Nachrichten

//发送消息前先获取消息
var sendMessage = getMessageBody("测试对象",'CTARemind',getCtaDate('BTC_USDT','120','0','2020-05-1620:00:00'));

//把机器人ID和消息体通过getArgs()方法获取，并传入基础参数。
var param = getParam("1.0.0",AK,getArgs(17777,sendMessage));

1. Führen Sie die Hauptmethode aus, senden Sie die Nachricht und verwenden Sie die Methode GetCommand (), um die Nachricht abzurufen

function main(){
    while(true) { 
        var cmd = GetCommand()
        if (cmd) { 
            Log(cmd)
        }
        Sleep(1000) 
    }
}

Nachricht erfolgreich gesendet: Nachricht erfolgreich empfangen:

Fall 3: Verwenden Sie die Methoden GetRobotList und GetRobotDetail der erweiterten API, um Roboterdaten zu überwachen und anzuzeigen.

Schauen wir uns zunächst die Parameterbeschreibungen der beiden Methoden an. GetRobotList(offset, length, robotStatus, label)：

GetRobotDetail(RobotId)：

1. Holen Sie sich die Roboterliste über die Methode GetRobotList

//获取机器人列表信息
var robotListJson = getAPIInfo('GetRobotList',getArgs(OFF_SET,PAGE_LENGTH,-1));
var robotList = robotListJson.data.result.robots;

1. Roboterdetails abrufen

//获取机器人详情信息
var robotDetailJson = getAPIInfo('GetRobotDetail',getArgs(robotId));
var robotDetail = robotDetailJson.data.result.robot;

1. Die Konsole gibt Tabellendaten aus

function getLogPrient(infoArr){
    return table = {
            type: 'table',
            title: '奥克量化的机器人展示',
            cols: ['机器人ID','机器人名称','策略名称','下次扣费时间','已经消耗时间ms','已经消耗金额CNY','最近活跃时间','是否公开'],
            rows: infoArr
        };
}

1. Zusammenfassend gibt es folgende Codes Quellcode-Adresse:[OakQuant] - Verwenden Sie die erweiterte API, um Roboterinformationen abzurufen und anzuzeigen

var URL = "https://www.fmz.com/api/v1?";
var AK = "b3a53d3XXXXXXXXXXXXXXXXXXX866fe5";//这里替换成你自己的AccessKey
var SK = "1d9ddd7XXXXXXXXXXXXXXXXXXX85be17";//这里替换成你自己的SecretKey
var OFF_SET = 0;//查询的页码下标
var PAGE_LENGTH = 5;//查询页的数据长度

function main() {
    LogReset();
    while(true){
        //获取机器人列表信息
        var robotListJson = getAPIInfo('GetRobotList',getArgs(OFF_SET,PAGE_LENGTH,-1));
        //取出机器人列表信息
        var robotList = robotListJson.data.result.robots;
        //创建展示机器人信息的数组
        var infoArr = new Array();
        var infoArr_index = 0;
        for (index = 0; index < robotList.length; index++) {
            var robot = robotList[index];
            //取出当前循环到的机器人ID
            var robotId = robot.id;
            //获取机器人详情信息
            var robotDetailJson = getAPIInfo('GetRobotDetail',getArgs(robotId));
            var robotDetail = robotDetailJson.data.result.robot;
            //转换详情为数组对象
            var arr = getLogPrientItem(robotDetail);
            infoArr[infoArr_index] = arr;
            infoArr_index++;
        }
        Log("infoArr:",infoArr);
        LogStatus('`' + JSON.stringify(getLogPrient(infoArr)) + '`');
        Sleep(30000);
    }
}

function getLogPrient(infoArr){
    return table = {
            type: 'table',
            title: '奥克量化的机器人展示',
            cols: ['机器人ID','机器人名称','策略名称','下次扣费时间','已经消耗时间ms','已经消耗金额CNY','最近活跃时间','是否公开'],
            rows: infoArr
        };
}

//通过参数获取API信息
function getAPIInfo(method,dateInfo){
    //获取5个基础参数对象
    var param = getParam("1.0.0",AK,method,dateInfo);
    //Log("param:",param);
    //获取拼接参数md5加密后的结果
    var md5Result = md5(param);
    //赋值加密结果到基础参数对象中
    param.sign = md5Result;
    //获取请求api的URL
    var finalUrl = getFinalUrl(param);
    //Log("finalUrl:",finalUrl);
    //执行请求并打印结果
    var info = HttpQuery(finalUrl);
    //Log("info:",info);
    return JSON.parse(info);
}

//获取基础5个参数的对象
function getParam(version,ak,method,args){
    return {
        'version': version,
        'access_key': ak,
        'method': method,
        'args': JSON.stringify(args),
        'nonce': new Date().getTime()
    }
}

//执行md5加密
function md5(param){
    var paramUrl = param.version+"|"+param.method+"|"+param.args+"|"+param.nonce+"|"+SK
    //Log("paramUrl:",paramUrl);
    return Hash("md5", "hex", paramUrl)
}

//获取最终请求URL
function getFinalUrl(param){
    return URL+"access_key="+AK+"&nonce="+param.nonce+"&args="+param.args+"&sign="+param.sign+"&version="+param.version+"&method="+param.method;
}

//js中不支持...args的命名方式，所以改用arguments关键字获取参数数组
function getArgs(){
    return [].slice.call(arguments);
}

//获取展示详情对象'机器人ID','机器人名称','策略名称','下次扣费时间','已经消耗时间ms','已经消耗金额CNY','最近活跃时间','是否公开'],
function getLogPrientItem(robotDetail){
    var itemArr = new Array();
    var iteArr_index = 0;
    itemArr[iteArr_index++] = robotDetail.id;
    itemArr[iteArr_index++] = robotDetail.name;
    itemArr[iteArr_index++] = robotDetail.strategy_name;
    itemArr[iteArr_index++] = robotDetail.charge_time;
    itemArr[iteArr_index++] = robotDetail.charged;
    itemArr[iteArr_index++] = robotDetail.consumed/1e8;
    itemArr[iteArr_index++] = robotDetail.refresh;
    itemArr[iteArr_index++] = robotDetail.public == 0?"已公开":"未公开";
    return itemArr;
}

Effektanzeige:

Abschluss

Im tatsächlichen Ausbau lassen sich noch weitere interessante Funktionen realisieren. Verwenden Sie beispielsweise die Methode CommandRobot, um jeden Roboter einen Heartbeat-Check an Roboter A senden zu lassen. Wenn Roboter A feststellt, dass eine Maschine keinen Heartbeat hat, der Roboter aber noch läuft, kann er über die FMZ-Servicenummer einen Alarm ausgeben. Auf diese Weise können Alarme vermieden werden, die zu Programmabstürzen führen können, wie z. B. tote _C()-Schleifen. Ich hoffe, dass durch meine Inspiration dieses Mal immer mehr interessante Funktionen für die FMZ-Plattform entwickelt und als Open Source für alle bereitgestellt werden können. Abschließend möchte ich der FMZ-Plattform und all den großartigen Menschen, darunter Herrn Meng, Herrn Chao und Herrn Z, für ihre Unterstützung und Hilfe danken. Danke~