Genesis Arbitrage

Genesis Arbitrage · · 3 min de lecture

Clé API

Une clé API est une longue chaîne aléatoire par laquelle un service sait qui a envoyé une requête : à quel compte elle appartient, à quel forfait et quelles données elle peut recevoir. Pour un programme, la clé joue le rôle d’un mot de passe : quiconque connaît la chaîne agit au nom du propriétaire.

Comment la clé est envoyée

La clé voyage dans un en-tête de chaque requête, tandis que les filtres vont dans l’URL. Dans Genesis API, l’en-tête est X-API-Key et la clé ressemble à gns_live_…. L’exemple demande les signaux alpha notés de Signaux IA :

import os
import requests

key = os.environ.get("GENESIS_API_KEY")
if not key:
    raise SystemExit("définissez GENESIS_API_KEY sur le serveur")

r = requests.get(
    "https://api.genesisarbitrage.com/v1/ai/signals",
    headers={"X-API-Key": key},  # la clé va uniquement dans l’en-tête
    params={"category": "alpha"},  # les filtres vont dans l’URL
    timeout=10,
)
if r.status_code == 401:
    # la clé est absente, invalide ou révoquée
    print(r.json()["error"]["code"])  # invalid_key
elif r.ok:
    print("signaux alpha :", r.json()["meta"]["count"])

On utilise un en-tête parce que l’URL de la requête, chaîne de requête comprise, se retrouve dans les journaux du serveur web et des proxys, et dans l’historique du navigateur si quelqu’un l’ouvre dedans. La documentation de Genesis API est claire : ne passez jamais la clé dans les paramètres de requête, ne l’intégrez jamais au code d’un site ou d’une application, et faites les requêtes depuis votre propre serveur uniquement. Les exchanges font de même : Binance reçoit la clé dans l’en-tête X-MBX-APIKEY, et les requêtes de compte sont en plus signées avec une seconde clé, l’API secret.

Comment stocker la clé

Clé d’exchange et clé Genesis API

Clé d’exchangeClé Genesis API
DroitsLire, trader, retirer : ce que vous activezLecture des données uniquement
Une fuite exposeLes transactions et retraits de votre compteVotre quota d’appels
ProtectionPas de retraits, liste blanche d’IPRéémission dans votre profil

Une clé Genesis API est en lecture seule : elle ne peut ni passer d’ordres ni retirer de l’argent. Les erreurs de clé et leurs codes figurent dans les sections Authentification et Erreurs.

Voir aussi : API, endpoint, rate limit, clé API : obtenir, stocker, réémettre et révoquer.

Questions et réponses

Puis-je créer plusieurs clés Genesis API ?

Non, un compte a une seule clé. « Réémettre » vous donne une nouvelle clé et désactive l’ancienne immédiatement.

Où obtenir une clé Genesis API ?

Dans votre profil, dans le bloc « Genesis API », une fois un forfait API payé. Le bouton « Obtenir la clé » ouvre la fenêtre « Votre clé API » avec un bouton « Copier ».