Introduction

Bonjour à tous, je suis “Oak Quantitative”. En raison du rappel des tendances du marché que j’ai développé il y a quelque temps [Suivi du tableau de bord】 est largement apprécié de tous, et il existe des rappels simultanés du compte de service du même nom [Oak Quantitative], qui fournit aux investisseurs nouveaux et anciens une nouvelle référence pour juger les tendances du marché. Profitant de cette popularité, nous avons commencé à nous connecter à l’API étendue de FMZ pour réaliser la communication de messages entre les robots et envoyer directement des alertes de marché aux robots désignés. Cet article donne deux exemples de scénarios d’application pour stimuler la discussion. J’espère que vous pourrez développer des choses plus intéressantes…

Cet article présente principalement : 1. Comment les développeurs se connectent-ils à l’API étendue de FMZ via le langage JS ? (Cet article prend la méthode GetNodeList comme exemple) 2. Cas 1 : utilisez la méthode CommandRobot de l’API étendue pour implémenter la communication de messages entre le robot de surveillance et d’autres robots. 3. Cas 2 : utilisez la méthode GetRobotDetail de l’API étendue pour obtenir une surveillance et un affichage unifiés de plusieurs données de robot.

1. Utilisez JS pour vous connecter à l’API étendue de FMZ

1. Demandez AccessKey et SecretKey (ci-après dénommés AK et SK). Nous appliquons dans le menu [Paramètres du compte] -> [Interface API] -> [Créer une nouvelle ApiKey] sur le site officiel de FMZ, puis obtenons un ensemble d’AK et SK et les enregistrons. (Les AK et SK de FMZ ne sont pas comme des échanges où ils ne sont visibles que la première fois qu’ils sont créés. Dans FMZ, nous pouvons visualiser les données complètes de nos AK et SK à tout moment dans le menu [Interface API])

2. Développer selon la documentation de l’API étendue Tout d’abord, examinons les étapes clés de la demande d’API

3. Interface API FMZ :

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

1. Demander les paramètres de base

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

1. L’URL de la demande complète est concaténée sous la forme d’un paramètre de point d’interrogation passant

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

1. Méthode de signature

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

1. Pour résumer, il existe les codes suivants Adresse du code source :[OakQuant]-Démo de l’API d’extension FMZ d’amarrage JS

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);
}

Cas 2 : Utilisation de la méthode CommandRobot de l’API étendue pour implémenter la communication de messages entre les robots

Sur la base du code ci-dessus, utilisons la méthode CommandRobot pour implémenter la communication de messages entre les robots.

Tout d’abord, examinons les deux paramètres requis par la méthode CommandRobot(RobotId, Cmd).

Connaissant la signification des paramètres, implémentons ensuite cette méthode d’appel.

1. Obtenez l’ID du robot sur la page des détails du robot :

2. Implémenter la méthode d’obtention du message Cmd

//获取消息头信息
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. Modifier le code d’envoi des messages

//发送消息前先获取消息
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. Exécutez la méthode principale, envoyez le message et utilisez la méthode GetCommand() pour obtenir le message

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

Message envoyé avec succès : Réception du message avec succès :

Cas 3 : utilisez les méthodes GetRobotList et GetRobotDetail de l’API étendue pour surveiller et afficher les données du robot.

De même, examinons d’abord les descriptions des paramètres des deux méthodes GetRobotList(offset, length, robotStatus, label)：

GetRobotDetail(RobotId)：

1. Obtenez la liste des robots via la méthode GetRobotList

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

1. Obtenir les détails du robot

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

1. La console génère des données de table

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

1. Pour résumer, il existe les codes suivants Adresse du code source :[OakQuant] - Utilisez l’API étendue pour obtenir des informations sur le robot et les afficher

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;
}

Affichage des effets :

Conclusion

Dans une extension réelle, des fonctions plus intéressantes peuvent être réalisées. Par exemple, utilisez la méthode CommandRobot pour permettre à chaque robot d’envoyer une vérification de pulsation au robot A. Si le robot A détecte qu’une machine n’a pas de pulsation, mais que le robot est toujours en cours d’exécution, il peut émettre une alarme via le numéro de service FMZ. De cette façon, les alarmes pouvant provoquer des blocages de programme, telles que les boucles mortes _C(), peuvent être évitées. J’espère que grâce à mon inspiration cette fois-ci, la plateforme FMZ pourra avoir de plus en plus de fonctions intéressantes développées et open source par tous. Enfin, je voudrais remercier la plateforme FMZ et toutes les personnes formidables, notamment M. Meng, M. Chao et M. Z pour leur soutien et leur aide. Merci~