O recurso está a ser carregado... Carregamento...

Guia de acesso ao Protocolo Geral para Inventores de Plataformas de Negociação Quantificadas

Autora:Inventor quantificado - sonho pequeno, Criado: 2024-10-29 14:37:56, Atualizado: 2024-11-12 21:58:55

[TOC]

As plataformas de negociação quantitativa do inventor suportam inúmeras trocas de criptomoedas e são fechadas para as principais trocas no mercado. No entanto, ainda há muitas trocas que não estão fechadas e para os usuários que precisam usá-las, o acesso é possível através do protocolo geral de quantificação do inventor.RESTacordo ouFIXA plataforma do protocolo também pode ser acessada.

Este artigo será sobreRESTO protocolo de acesso, por exemplo, explica como usar o protocolo geral da plataforma de negociação quantitativa do inventor para envelopar e acessar a API da OKX.

O processo de trabalho do Protocolo Geral é: Processo de solicitação: Exemplos de políticas executadas no administrador -> Procedimentos de protocolo geral -> API da bolsa Processo de resposta: API da bolsa -> Protocolo Geral -> Exemplos de políticas executadas no administrador

1 Configuração de bolsas

A página do inventor da plataforma de negociação quantitativa para configurar a bolsa:

https://www.fmz.com/m/platforms/add

Escolha o protocolo: Escolha o "Protocolo Geral".
Endereço do serviço: O protocolo geral é essencialmente um serviço RPC Por isso, é necessário especificar claramente o endereço do serviço, a porta, quando configurar o exchange.托管者上运行的策略实例 -> 通用协议程序No processo, o administrador só sabe onde acessar o protocolo geral. Por exemplo:http://127.0.0.1:6666/OKXOs servidores geralmente executam os programas do protocolo geral no mesmo dispositivo (servidor), então o endereço do serviço é escrito no local (localhost) e o porto é usado em um sistema não ocupado.
Chave de acesso:托管者上运行的策略实例 -> 通用协议程序O processo é executado através de uma rede de computadores, que transmite a informação de configuração do exchange.
Chave secreta:托管者上运行的策略实例 -> 通用协议程序O processo é executado através de uma rede de computadores, que transmite a informação de configuração do exchange.
As pessoas estão a morrer. É o nome dado a um objeto de uma bolsa de valores num inventor de uma plataforma de negociação quantitativa.

A imagem abaixo mostra a configuração do plugin OKX divulgado no artigo:

Informações sobre a configuração da chave secreta da OKX:

accessKey:  accesskey123    // accesskey123 这些并不是实际秘钥，仅仅是演示
secretKey:  secretkey123
passphrase: passphrase123

2  Implementar administradores e protocolos gerais (plugins)

1o, administrador Para executar qualquer estratégia real em uma plataforma de negociação quantitativa do inventor, é necessário implantar um administrador, o qual pode ser consultado no tutorial da plataforma, que não será descrito aqui.
2, Plugins de protocolo geral O servidor e o protocolo geral são geralmente implementados no mesmo dispositivo, e os programas de protocolo geral (serviços) podem usar qualquer linguagem para escrever projetos, sendo que este artigo é escrito em Python 3 e pode ser executado diretamente, como executar qualquer programa Python. É claro que o FMZ também tem suporte para executar programas Python, mas também pode usar o protocolo geral como um disco físico para fornecer aos inventores de plataformas de negociação quantitativa suporte para acesso a APIs de exchanges não encapsuladas. O protocolo geral é executado e a escuta é iniciada:http://127.0.0.1:6666O protocolo pode ser usado para definir um caminho específico, por exemplo./OKXO que é que ele está a fazer?

3, instância de política solicita a função API do FMZ

Quando a função API da plataforma FMZ é chamada na política, o protocolo geral recebe solicitações do administrador. Também é possível testar ferramentas de depuração da plataforma, como:

Página de ferramentas de depuração:

https://www.fmz.com/m/debug

function main() {
    return exchange.GetTicker("LTC_USDT")
}

Chamadaexchange.GetTicker()Funções, protocolo geral recebe solicitações:

POST /OKX HTTP/1.1 
{
    "access_key":"xxx",
    "method":"ticker",
    "nonce":1730275031047002000,
    "params":{"symbol":"LTC_USDT"},
    "secret_key":"xxx"
}

access_key: A chave secreta da bolsa configurada no texto acima quando a plataforma "configure a troca"
secret_key: chave secreta da bolsa configurada quando a plataforma "configura a bolsa" no texto acima
método: relacionado com a chamada da interface na política, chamadaexchange.GetTicker()O que é isso?methodOu seja,ticker。
Nonce: Tempo no qual ocorreu o pedido.
Parâmetros: Parâmetros relacionados quando uma chamada de interface ocorre na política, neste casoexchange.GetTicker()Os parâmetros que são usados são:{"symbol":"LTC_USDT"}。

4. Procedimentos de protocolo geral para acessar a interface da bolsa

Quando um protocolo geral recebe uma solicitação do administrador, pode ser informado sobre as informações que a solicitação contém: a função API da plataforma (incluindo informações de parâmetros) e a chave secreta do exchange.

Com base nessas informações, o protocolo geral pode acessar a interface da bolsa, obter os dados necessários ou executar certas operações.

Normalmente, as interfaces de exchanges têm métodos como GET / POST / PUT / DELETE, divididos em interfaces públicas e privadas.

Interface pública: Interface sem necessidade de autenticação de assinatura, solicitada diretamente no processo de protocolo geral.
Interfaces privadas: Interfaces que exigem verificação de assinatura, que exigem a implementação de assinaturas em procedimentos de protocolo geral e, em seguida, solicitam as interfaces API dessas exchanges.

O processo de protocolo geral recebe dados de resposta da interface do exchange para processá-los, formando os dados esperados pelo administrador (descrição abaixo). Referência para a OKX Exchange, uma implementação da classe CustomProtocolOKX no paradigma de protocolo geral do PythonGetTicker、GetAccountFunções iguais.

5. O protocolo geral responde aos administradores

Quando um programa de protocolo geral acessa a interface API de uma bolsa, executa certas operações ou obtém certos dados, precisa dar feedback aos administradores.

Os dados de feedback para os administradores variam de acordo com a interface em que a política é chamada, divididos em duas categorias:

O protocolo geral chamou a interface da bolsa com sucesso:
```
{
    "data": null,  // "data" can be of any type 
    "raw": null    // "raw" can be of any type 
}
```
- data: estrutura específica do campo e solicitações recebidas pelo protocolo geralmethodRelacionado, a estrutura de dados utilizada para construir a função final de retorno da API da plataforma FMZ, listando todas as interfaces abaixo.
- raw: Este campo pode transmitir dados primários de respostas de interfaces de API da bolsa, como por exemploexchange.GetTicker()A estrutura do ticker que a função retorna, registrada no campo Info da estrutura do ticker é:rawQuadro edataOs dados dos campos; funções da API da plataforma, algumas não precisam deste dado.
Falha no protocolo geral para chamar a interface da bolsa (errores de negócios, erros de rede, etc.)
```
{
    "error": ""    // "error" contains an error message as a string
}
```
- error: mensagem de erro, que aparece no registro de erros da área do diário de páginas do disco físico da plataforma FMZ, ferramentas de depuração, etc.;

Os dados de resposta do protocolo geral recebidos pelo programa de estratégia de demonstração:

// FMZ平台的调试工具中测试
function main() {
    Log(exchange.GetTicker("USDT"))       // 交易对不完整，缺少BaseCurrency部分，需要通用协议插件程序返回报错信息： {"error": "..."}
    Log(exchange.GetTicker("LTC_USDT"))
}

6. Convenções de estrutura de dados no protocolo geral

O conteúdo acima é um breve processo do programa de protocolo geral envolvido no acesso à API de câmbio (FMZ não encapsulado), que explica apenas as chamadas no FMZ.exchange.GetTicker()O processo de função. A seguir, detalhes sobre a interação de todas as funções da API da plataforma serão descritos em detalhes.

A plataforma encapsula funções comuns de todas as exchanges, todas unificadas em uma função, como a função GetTicker, que solicita informações de mercado de uma variedade atual, que é basicamente uma API disponível em todas as exchanges. Assim, quando o administrador acessa a interface API embalada pela plataforma no exemplo da política, ele envia um pedido ao plugin "Protocolo Geral" (mencionado acima):

POST /OKX HTTP/1.1 
{
    "access_key": "xxx",
    "method": "ticker",
    "nonce": 1730275031047002000,
    "params": {"symbol":"LTC_USDT"},
    "secret_key": "xxx"
}

Quando as funções de API que são encapsuladas em diferentes plataformas de inventores são chamadas em políticas (por exemplo, GetTicker), o formato de solicitação enviado pelo administrador ao protocolo geral também será diferente.methodeparamsO protocolo é uma ferramenta de comunicação que permite a criação de um protocolo geral.methodO conteúdo é apenas para executar uma operação específica.

Bolsa de Valores

Por exemplo, o par de transações atual é:ETH_USDTOs dados que os administradores esperam que o protocolo geral responda são escritos principalmente no campo de dados, mas também é possível adicionar um campo raw para registrar os dados originais da interface do exchange.

GetTicker

Método de campo: ticker ticker
O campo de params:
```
{"symbol":"ETH_USDT"}
```