Введение

Всем привет, я «Oak Quantitative». Из-за напоминания о рыночных тенденциях, которое я разработал некоторое время назад [Мониторинг панели инструментов】 пользуется всеобщей любовью, и одновременно появляются напоминания из одноименного сервисного аккаунта [Oak Quantitative], который предоставляет новым и старым инвесторам новую справочную информацию для оценки рыночных тенденций. Пользуясь этой популярностью, мы начали подключаться к расширенному API FMZ, чтобы реализовать обмен сообщениями между роботами и напрямую отправлять рыночные оповещения назначенным роботам. В этой статье в качестве примеров приводятся два сценария применения, чтобы стимулировать обсуждение. Надеюсь, вы сможете разработать более интересные вещи…

В этой статье в основном представлены: 1. Как разработчики могут подключиться к расширенному API FMZ через язык JS? (В этой статье в качестве примера рассматривается метод GetNodeList) 2. Случай 1: использование метода CommandRobot расширенного API для реализации обмена сообщениями между роботом-монитором и другими роботами. 3. Случай 2: использование метода GetRobotDetail расширенного API для достижения унифицированного мониторинга и отображения данных нескольких роботов.

1. Используйте JS для подключения к расширенному API FMZ

1. Подайте заявку на получение AccessKey и SecretKey (далее именуемые AK и SK). Заходим в меню [Настройки аккаунта] -> [Интерфейс API] -> [Создать новый ApiKey] на официальном сайте FMZ, после чего получаем набор AK и SK и записываем их. (AK и SK FMZ не похожи на биржи, где они видны только при первом создании. В FMZ мы можем в любое время просмотреть полные данные наших AK и SK в меню [Интерфейс API])

2. Разрабатывать согласно документации расширенного API Сначала давайте рассмотрим основные этапы запроса API.

3. Интерфейс API FMZ:

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

1. Запросить основные параметры

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

1. Полный URL-адрес запроса объединяется в форме передачи параметров со знаком вопроса.

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

1. Метод подписи

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

1. Подводя итог, можно сказать, что существуют следующие коды: Адрес исходного кода:[Oak Quantitative]-JS docking FMZ extension 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);
}

Случай 2: Использование метода CommandRobot расширенного API для реализации обмена сообщениями между роботами

На основе приведенного выше кода давайте воспользуемся методом CommandRobot для реализации обмена сообщениями между роботами.

Сначала давайте рассмотрим два параметра, требуемые методом CommandRobot(RobotId, Cmd).

Зная значение параметров, давайте реализуем этот вызывающий метод.

1. Получите идентификатор робота на странице сведений о роботе:

2. Реализовать метод получения сообщения 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. Измените код отправки сообщений.

//发送消息前先获取消息
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. Выполните основной метод, отправьте сообщение и используйте метод GetCommand() для получения сообщения.

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

Сообщение успешно отправлено: Получение сообщения успешно:

Случай 3: использование методов GetRobotList и GetRobotDetail расширенного API для мониторинга и отображения данных робота.

Аналогично, давайте сначала рассмотрим описания параметров двух методов. GetRobotList(offset, length, robotStatus, label)：

GetRobotDetail(RobotId)：

1. Получить список роботов с помощью метода GetRobotList

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

1. Получить данные о роботе

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

1. Консоль выводит табличные данные

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

1. Подводя итог, можно сказать, что существуют следующие коды: Адрес исходного кода:[OakQuant]-Используйте расширенный API для получения информации о роботе и ее отображения.

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

Эффект отображения:

Заключение

При реальном расширении можно реализовать более интересные функции. Например, используйте метод CommandRobot, чтобы каждый робот отправлял проверку пульса роботу A. Если робот A обнаруживает, что у машины нет пульса, но робот все еще работает, он может подать сигнал тревоги через сервисный номер FMZ. Таким образом, можно избежать сигналов тревоги, которые могут привести к зависанию программы, например, мертвых циклов _C(). Надеюсь, что благодаря моему вдохновению на этот раз платформа FMZ сможет разрабатывать все больше и больше интересных функций и открывать их исходный код для всех желающих. Наконец, я хотел бы поблагодарить платформу FMZ и всех замечательных людей, включая г-на Мэн, г-на Чао и г-на Z, за их поддержку и помощь. Спасибо~