En la carga de los recursos... Cargando...

Nuevas capacidades cuantificadas por los inventores: fácil creación de servicios HTTP con _Serve

El autor:Los inventores cuantifican - sueños pequeños, Creado: 2024-11-12 22:10:49, Actualizado: 2024-11-15 09:27:20

[TOC] ¿Qué quieres decir?

img

En el desarrollo de transacciones cuantificadas y estrategias de automatización, a veces se utiliza el servicio http._Serve()Función que ofrece a los usuarios la capacidad de crear servicios HTTP, HTTPS y TCP con flexibilidad. A través de esta función, los desarrolladores pueden simplificar el proceso de configuración de servicios y implementar más servicios personalizados en entornos cuantificados, lo que hace que el diseño de políticas sea más fluido y fácil._Serve()Los escenarios de uso y las operaciones básicas de las funciones te ayudarán a cuantificar esta nueva función de inventor rápido.

¿Qué es esto?_Serve()La página web de la plataforma se ha actualizado en la API:

https://www.fmz.com/syntax-guide/fun/global/__serve


Las necesidades

La plataforma está mejorada._Serve()Función (porque el lenguaje JavaScript anterior no tenía funciones para crear servicios, la función solo soportaba políticas de la lengua JavaScript), es decir, que las políticas tienen la capacidad de crear servicios en la red. Sobre la base de esta función, podemos desarrollar muchas funciones para resolver muchas necesidades. Por ejemplo, que las políticas tengan interfaces externas, transmisión de datos, compatibilidad con plataformas de protocolos generales, funcionalidad de intercambio sin envases sin soporte de la plataforma FMZ, etc.

Este artículo es un ejemplo de la necesidad de: "la funcionalidad del protocolo general de la plataforma de cooperación sin problemas para los intercambios que no son compatibles con la plataforma FMZ"."Guía del Protocolo General"En el caso de las operaciones OKX, utilizamos el lenguaje Python, por lo que el modo de compra está envuelto en la API (ya que FMZ es compatible con OKX, OKX es sólo un ejemplo y se aplica a otros intercambios sin acceso a la plataforma FMZ)._Serve()Después de las funciones, las estrategias del lenguaje JavaScript para acceder al protocolo general son más sencillas.

Vamos a integrar directamente en la política el paquete de protocolo general de la interfaz de intercambio que se va a empaquetar como "repertorio de plantillas", lo que permite un acceso sin problemas a los intercambios que no están soportados en FMZ. Para más información sobre cómo configurar los objetos de intercambio de "protocolo general", consulte el artículo:

https://www.fmz.com/digest-topic/10518

  • La configuración de los intercambios de protocolo general en la plataforma es la siguiente:

    img

    En el diseño de la plantilla, se puede usar/OKXIdentificar el objeto del intercambio de protocolo general al que pertenece el intercambio de configuración.


Implementación de la plantilla de protocolo general

Primero, se crea una nueva política en la plataforma de comercio cuantitativo de los inventores, con el tipo de política configurado como una librería de plantillas y el lenguaje de la política como el lenguaje JavaScript.

Diseño de parámetros de plantilla

Para crear una buena plantilla de estrategias, añadimos 3 parámetros:

img

Luego se puede comenzar a diseñar y escribir el código de la plantilla de protocolo general.

Implementación de código

El código está escrito en el estilo TS.$.startService()Las funciones son las funciones de interfaz de las plantillas, utilizadas para iniciar el servicio de protocolo general.

// @ts-check

$.startService = function (address, port, proxyConfig) {
    __Serve(`http://${address}:${port}`, function (ctx, proxyConfig) {
        // interface
        interface IData {
            data: object
            raw: object
        }
        
        interface IError {
            error: any
        }
        
        // custom protocol for OKX
        class CustomProtocolOKX {
            apiBase: string = "https://www.okx.com"
            accessKey: string
            secretKey: string
            passphrase: string
            proxyConfig: string = ""
            simulate: boolean = false
            
            constructor(accessKey: string, secretKey: string, passphrase: string, simulate?: boolean, proxyConfig?: string) {
                this.accessKey = accessKey
                this.secretKey = secretKey
                this.passphrase = passphrase
                if (typeof(simulate) == "boolean") {
                    this.simulate = simulate
                }
                this.proxyConfig = proxyConfig
            }
            
            httpReq(method: string, path: string, query: string = "", params: {[key: string]: any} = {}, headers: {key: string, value: string | ArrayBuffer}[] = []): {[key: string]: any} {
                let ret = null
                let options = {
                    method: method,                    
                    headers: {
                        'User-Agent': 'Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.1.6) Gecko/20091201 Firefox/3.5.6', 
                        'Content-Type': 'application/json; charset=UTF-8',
                        'x-simulated-trading': this.simulate ? "1" : "0"
                    },
                }
                
                // headers
                if (Array.isArray(headers) && headers.length > 0) {
                    for (var pair of headers) {
                        options.headers[pair.key] = pair.value
                    }
                }
                
                let url = ""
                if (method == "GET") {
                    if (typeof(query) == "string" && query.length > 0) {
                        url = `${this.apiBase}${path}?${query}`
                    } else {
                        url = `${this.apiBase}${path}`
                    }
                } else {
                    url = `${this.apiBase}${path}`
                    options.body = JSON.stringify(params)
                }

                // request
                try {
                    if (this.proxyConfig != "") {
                        url = `${this.proxyConfig}${url}`
                    }
                    ret = JSON.parse(HttpQuery(url, options))
                } catch(e) {
                    return null
                }
    
                return ret
            }

            callSignedAPI(method: string, path: string, query: string = "", params: {[key: string]: any} = {}): {[key: string]: any} {
                const strTime = new Date().toISOString().slice(0, -5) + 'Z'
                let jsonStr = ""
                if (method == "GET") {
                    jsonStr = Object.keys(params).length > 0 ? JSON.stringify(params) : ""
                } else {
                    jsonStr = Object.keys(params).length > 0 ? JSON.stringify(params) : "{}"
                }                
                let message = `${strTime}${method}${path}${jsonStr}`
                if (method === "GET" && query !== "") {
                    message = `${strTime}${method}${path}?${query}${jsonStr}`
                }

                const signature = Encode("sha256", "string", "base64", message, "string", this.secretKey)
                let headers = []
                headers.push({key: "OK-ACCESS-KEY", value: this.accessKey})
                headers.push({key: "OK-ACCESS-PASSPHRASE", value: this.passphrase})
                headers.push({key: "OK-ACCESS-TIMESTAMP", value: strTime})
                headers.push({key: "OK-ACCESS-SIGN", value: signature})                

                return this.httpReq(method, path, query, params, headers)
            }
            
            urlEncode(params: {[key: string]: string | number}): string {
                let encodeParams: string[] = []
                for (const [key, value] of Object.entries(params)) {
                    encodeParams.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
                }

                return encodeParams.join("&")
            }

            symbol2Inst(symbol: string): string {
                let arr = symbol.split("_")
                if (arr.length >= 2) {
                    return `${arr[0]}-${arr[1]}`.toUpperCase()
                } else {
                    return `${arr[0]}-USDT`.toUpperCase()
                }
            }

            getSymbol(inst: string): string {
                let arr = inst.split("-")
                if (arr.length >= 2) {
                    return `${arr[0]}_${arr[1]}`.toUpperCase()
                } else {
                    return `${arr[0]}-USDT`.toUpperCase()
                }
            }
            
            // The following code encapsulates OKX's interface
            GetTicker(symbol: string): IData | IError {
                // GET /api/v5/market/ticker , param: instId 

                let inst = this.symbol2Inst(symbol)
                let ret = this.httpReq("GET", "/api/v5/market/ticker", `instId=${inst}`)

                let retData = {}
                for (var ele of ret["data"]) {
                    retData["symbol"] = this.getSymbol(ele["instId"])
                    retData["buy"] = ele["bidPx"]
                    retData["sell"] = ele["askPx"]
                    retData["high"] = ele["high24h"]
                    retData["low"] = ele["low24h"]
                    retData["open"] = ele["open24h"]
                    retData["last"] = ele["last"]
                    retData["vol"] = ele["vol24h"]
                    retData["time"] = ele["ts"]
                }

                return {data: retData, raw: ret}
            }
            
            GetAccount(): IData | IError {
                // GET /api/v5/account/balance
                
                let ret = this.callSignedAPI("GET", "/api/v5/account/balance")

                let retData = []
                for (var ele of ret["data"]) {
                    for (var detail of ele["details"]) {
                        let asset = {"currency": detail["ccy"], "free": detail["availEq"], "frozen": detail["ordFrozen"]}
                        if (detail["availEq"] == "") {
                            asset["free"] = detail["availBal"]
                        }
                        retData.push(asset)
                    }
                }
                
                return {data: retData, raw: ret}
            }

            IO(method: string, path: string, params: {[key: string]: any}): {[key: string]: any} {
                let ret = null 
                if (method == "GET") {
                    ret = this.callSignedAPI(method, path, this.urlEncode(params))
                } else {
                    ret = this.callSignedAPI(method, path, "", params)
                }

                return {data: ret}
            }
        }
        
        // protocol factory
        class ProtocolFactory {
            static createExWrapper(accessKey: string, secretKey: string, exName: string): any {
                let protocol = null
                if (exName == "/OKX") {
                    try {
                        let passphrase = ""
                        let simulate = false
                        let arrSecretKey = secretKey.split(",")

                        if (arrSecretKey.length == 2) {
                            secretKey = arrSecretKey[0]
                            passphrase = arrSecretKey[1]
                        } else if (arrSecretKey.length == 3) {
                            secretKey = arrSecretKey[0]
                            passphrase = arrSecretKey[1]
                            simulate = arrSecretKey[2] == "simulate" ? true : false 
                        } else {
                            return null
                        }
                        protocol = new CustomProtocolOKX(accessKey, secretKey, passphrase, simulate, proxyConfig)
                    } catch(e) {
                        Log("e.name:", e.name, "e.stack:", e.stack, "e.message:", e.message)
                        return null
                    }
                }
                return protocol
            }
        }
        
        // http service
        let resp = {}
        let reqMethod = ctx.method()
        let reqPath = ctx.path()
        let httpMethod = ctx.header("Http-Method")
        let reqBody = null

        try {
            reqBody = JSON.parse(ctx.body())
        } catch(e) {
            resp = {error: {name: e.name, stack: e.stack, message: e.message, errDesc: "JSON parse error."}}
        }

        // onPost
        if (reqMethod == "POST") {
            if (!["access_key", "secret_key", "method", "params"].every(key=> key in reqBody)) {
                resp = {error: {reqBody: reqBody, errDesc: "reqBody error."}}
            }

            if ("error" in resp) {
                ctx.write(JSON.stringify(resp))
                return 
            }

            let accessKey = reqBody["access_key"]
            let secretKey = reqBody["secret_key"]
            let method = reqBody["method"]
            let params = reqBody["params"]

            let protocol = ProtocolFactory.createExWrapper(accessKey, secretKey, reqPath)
            if (!protocol) {
                ctx.write(JSON.stringify({error: {errDesc: "createExWrapper error."}}))
                return 
            }

            // process GetTicker / GetAccount ...
            if (method == "ticker") {
                if (!["symbol"].every(key=> key in params)) {
                    resp = {error: {params: params, errDesc: "params error."}}
                } else {
                    let symbol = params["symbol"]
                    resp = protocol.GetTicker(symbol)
                }
            } else if (method == "accounts") {
                resp = protocol.GetAccount()
            } else if (method.slice(0, 6) == "__api_") {
                resp = protocol.IO(httpMethod, method.slice(6), params)
            } else {
                ctx.write(JSON.stringify({error: {method: method, errDesc: "method not support."}}))
                return 
            }

            ctx.write(JSON.stringify(resp))
        }
    }, proxyConfig)
}

function init() {
    $.startService(address, port, proxyConfig)
    Log("启动通用协议服务,address:", address, ",port:", port, "#FF0000")
    if (proxyConfig != "") {
        Log("设置代理:", proxyConfig, "#FF0000")
    }
}

En la actualidad, la red social de Internet tiene un espacio limitado, y no se puede implementar todas las interfaces, sólo se puede implementar una serie de aplicaciones.EncuestasEncuestas de activosLlamado por IOLos estudiantes interesados pueden implementar todas las interfaces; el diseño está terminado, el código de la plantilla se guarda, el nombre de la plantilla se guarda como: TypeScript version general protocol paradigma .


Estrategias de prueba

Una vez que hemos configurado OKX Exchange con apkey, secretkey, passwordphrase, etc., podemos escribir una política de prueba para probarlo.

La estrategia es seleccionar la biblioteca de modelos que hemos diseñado:

img

El código de la estrategia de prueba:

function main() {
    // 测试GetTicker
    Log(`exchange.GetTicker():`, exchange.GetTicker())

    // 测试GetAccount
    Log(`exchange.GetAccount():`, exchange.GetAccount())

    // 测试exchange.IO
    Log(`exchange.IO("api", "POST", "/api/v5/trade/cancel-all-after", "timeOut=0"):`, exchange.IO("api", "POST", "/api/v5/trade/cancel-all-after", "timeOut=0"))

    // 输出通用协议添加的交易所名称
    Log(`exchange.GetName():`, exchange.GetName())

    // 输出通用协议添加的交易所标签
    Log(`exchange.GetLabel():`, exchange.GetLabel())
}

Pruebas de ejecución

img

Como se puede ver, la estrategia es simplemente seleccionar una plantilla y lograr el acceso sin fisuras de la bolsa OKX (aunque la bolsa OKX ya lo apoya, por ejemplo, OKX sustituye a una bolsa FMZ que aún no está conectada).


Más.