Les ressources ont été chargées... Je charge...

Guide d'accès au protocole général pour les plateformes de négociation quantitative pour les inventeurs

Auteur:L'inventeur de la quantification - un petit rêve, Créé: 2024-10-29 14:37:56, Mis à jour: 2024-11-12 21:58:55

[TOC] Je vous en prie.

Les plateformes de trading quantifiées par les inventeurs prennent en charge de nombreux échanges de crypto-monnaie et sont enveloppées dans les échanges traditionnels sur le marché. Cependant, de nombreux échanges restent non enveloppés, et les utilisateurs qui ont besoin d'utiliser ces échanges peuvent y accéder via des protocoles généraux quantifiés par les inventeurs.RESTaccord ouLe nombre de personnesLes plateformes du protocole sont également accessibles.

Cet article est intituléRESTL'exemple de l'accès au protocole, expliquant comment utiliser le protocole général de la plate-forme de négociation quantitative des inventeurs pour envelopper et accéder à l'API de l'échange OKX.

Le processus de travail du protocole général est le suivant: Processus de demande: Exemple de stratégie en cours d'exécution sur le gestionnaire -> Procédure de protocole général -> API de l'échange Processus de réponse: API de l'échange -> Procédure de protocole général -> Exemple de stratégie en cours d'exécution sur le gestionnaire

1° Configurer les échanges

La page de configuration des plateformes de négociation quantitative par les inventeurs:

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

Sélectionnez le protocole: Sélectionnez le protocole général.
Adresse du service: Le protocole général est essentiellement un service RPC Il est donc nécessaire de spécifier clairement l'adresse du service, le port lors de la configuration de l'échange.托管者上运行的策略实例 -> 通用协议程序Les administrateurs ne savent où accéder au protocole général que pendant le processus. Par exemple:http://127.0.0.1:6666/OKXLe protocole général est généralement exécuté sur le même appareil (serveur) que l'hôte, de sorte que l'adresse du service est écrite sur le localhost et que le port est utilisé par un système non occupé.
Clé d' accès:托管者上运行的策略实例 -> 通用协议程序Au cours du processus, les informations de configuration de l'échange sont transmises.
Clé secrète:托管者上运行的策略实例 -> 通用协议程序Au cours du processus, les informations de configuration de l'échange sont transmises.
Le blogueur a écrit: Étiquette d'objet d'un échange sur une plateforme de négociation quantitative de l'inventeur, utilisée pour identifier un objet d'échange.

Voici une capture d'écran de la configuration du plugin OKX publié dans l'article:

Les informations de configuration de la clé secrète de l'échange OKX:

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

2, déployer des hôtes et des plugins

1er, le gestionnaire Pour exécuter n'importe quelle stratégie sur une plateforme de trading quantifié par l'inventeur, il est nécessaire de déployer un gestionnaire, qui peut être consulté dans les didacticiels de la plateforme.
2, le protocole général (plugin) Les hôtes et le protocole général sont généralement déployés sur le même appareil. Les programmes de protocole général (services) peuvent être écrits dans n'importe quel langage pour la conception. Bien sûr, il est également possible d'exécuter des programmes python sur FMZ, ou d'exécuter ce protocole général comme un disque dur pour fournir aux inventeurs une plate-forme de négociation quantitative pour l'accès à l'API de l'échange non enveloppé. Le protocole général est en cours d'exécution et les écouteurs commencent à écouter:http://127.0.0.1:6666Le protocole générique permet de tracer des chemins spécifiques, par exemple:/OKXIl y a des gens qui sont en train d'écrire.

3, l'instance de stratégie demande une fonction API pour FMZ

Lorsqu'une fonction API de la plate-forme FMZ est appelée dans la stratégie, le protocole général reçoit une demande de l'hôte. Des outils de débogage de la plate-forme peuvent également être testés, par exemple:

Le site de l'outil de débogage:

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

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

Appeléeexchange.GetTicker()Les fonctions, les protocoles génériques ont reçu la demande:

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

access_key: clé secrète de l'échange configurée lors de la "configuration de l'échange" de la plate-forme dans le texte ci-dessus
secret_key: clé secrète de l'échange configurée lors de la "configuration de l'échange" de la plate-forme dans l'article ci-dessus
méthode: liée à l'interface appelée dans la stratégie, appeléeexchange.GetTicker()Je ne sais pas.methodC'est à direticker。
Nonce: le moment où la demande a été faite.
Paramètres: paramètres liés à l'appel d'interface dans la politique, dans ce casexchange.GetTicker()Les paramètres sont les suivants:{"symbol":"LTC_USDT"}。

4, les procédures de protocole général pour accéder à l'interface de l'échange

Lorsque le protocole général reçoit une demande de l'administrateur, il peut être informé de l'information contenue dans la demande: fonction API de la plate-forme demandée (y compris les paramètres), clé secrète de l'échange, etc.

Sur la base de cette information, le protocole général peut accéder à l'interface de l'échange, obtenir les données requises ou effectuer certaines opérations.

Les interfaces d'échange ont généralement des méthodes telles que GET / POST / PUT / DELETE, qui sont divisées en interfaces publiques et privées.

Interface publique: Interface qui ne nécessite pas d'authentification de signature, directement demandée dans le protocole général.
Interfaces privées: interfaces qui nécessitent une authentification de la signature, qui nécessitent une signature dans un processus de protocole général et qui demandent ensuite une interface API à ces échanges.

Le protocole général reçoit les données de réponse de l'interface de l'échange, qui sont ensuite traitées pour constituer les données attendues par le dépositaire (voir ci-dessous). En référence à OKX Exchange, dans le cas de Python, le protocole personnalisé est une implémentation de classe OKXGetTicker、GetAccountLes fonctions égales.

5. Les protocoles génériques répondent aux administrateurs

Lorsqu'un protocole général accède à l'API d'un échange, exécute certaines opérations ou obtient certaines données, il doit retourner les résultats à l'administrateur.

Les données fournies aux hôtes diffèrent en fonction de l'interface utilisée pour l'appel de la stratégie.

Le protocole général a appelé l'interface de l'échange avec succès:
```
{
    "data": null,  // "data" can be of any type 
    "raw": null    // "raw" can be of any type 
}
```
- data: la structure spécifique du champ et les demandes reçues par le protocole généralmethodLes structures de données utilisées pour construire les fonctions d'API de la plateforme FMZ sont répertoriées ci-dessous.
- raw: ce champ peut transmettre des données brutes de la réponse de l'API de l'échange, par exempleexchange.GetTicker()La structure de ticker retournée par la fonction, enregistrée dans le champ Info de la structure de ticker estrawchamps etdataLes données des champs; les fonctions d'API de la plateforme, certaines ne nécessitent pas ces données.
Échec de l'interface d'appel du protocole général (erreur opérationnelle, erreur réseau, etc.)
```
{
    "error": ""    // "error" contains an error message as a string
}
```
- error: message d'erreur, qui s'affiche dans le journal d'erreur des zones de journal de page telles que le disque dur de la plateforme FMZ, les outils de débogage.

Les données de réponse du protocole général reçues par le programme de stratégie de démonstration:

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

Conventions sur la structure des données dans le protocole général

Ce qui précède est un bref processus de participation des protocoles généraux à l'API d'un échange d'accès (FMZ non enveloppé), qui n'explique que les appels dans les outils de débogage de la plate-forme FMZ.exchange.GetTicker()Le processus au moment de la fonction. Les détails d'interaction de toutes les fonctions API de plate-forme sont détaillés ci-dessous.

La plate-forme enveloppe les fonctionnalités communes des différents échanges, qui sont unifiées en une fonction, comme la fonction GetTicker, qui demande des informations de marché d'une certaine variété actuelle, qui est essentiellement l'API disponible pour toutes les échanges. Ainsi, lorsque, dans l'exemple de stratégie, l'administrateur accède à l'interface API enveloppée par la plate-forme, il envoie une demande au plugin "General Protocol" (mentionné ci-dessus):

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

Lorsque des fonctions d'API encapsulées par différentes plateformes d'inventeurs sont appelées dans la stratégie (par exemple, GetTicker), le format de demande envoyé par l'hôte au protocole général diffère également.methodetparamsLe protocole générique doit être conçu en fonction des principes suivants:methodLe contenu de l'interface peut être utilisé pour exécuter des opérations spécifiques.

Le marché au comptant

Par exemple, la paire de transactions en cours est:ETH_USDTLes données auxquelles les administrateurs s'attendent à ce que le protocole général réponde sont principalement écrites dans le champ de données, mais un champ RAW peut également être ajouté pour enregistrer les données originales de l'interface d'échange.

GetTicker

Le champ méthode:
Le champ params:
```
{"symbol":"ETH_USDT"}
```