Guide de démarrage rapide pour les utilisateurs utilisant des assistants de codage IA.
Aperçu
Ce document est une collection de compétences API BingX pour les assistants de codage IA, comprenant 15 modules de compétences couvrant les Futures perpétuels, le trading Spot, les Futures standards Coin-M, le copy trading et la gestion de compte.
Après l’installation, vous pouvez interagir directement en langage naturel avecl’IA pour consulter les données de marché, placer des trades et gérer vos comptes, sans avoir à écrire manuellement de code de requête API.
Assistants IA pris en charge :Claude Code,Cursor et d’autres assistants de codage IA prenant en charge les compétences.
Installer
- Installation générale (Claude Code / Cursor / autres)
| npx skills add BingX-API/api-ai-skills |
- Claude Code Installation dédiée (prise en charge des mises à jour automatiques)
| /plugin add BingX-API/api-ai-skills |
Pour les instructions d’installation détaillées, voir README.md
Présentation des compétences
- USDT-M perpétuels
| Nom de la compétence | Objectif | Autorisation requise |
| bingx-swap-market | Données de marché : prix, profondeur, K-line, taux de financement, intérêt ouvert, etc. | Incomplet |
| bingx-swap-trade | Opérations de trading : placement d’ordres, annulation d’ordres, réglage de l’effet de levier, mode de l'actif, etc. | Oui |
| bingx-swap-account | Informations du compte : soldes, positions en cours, taux de frais, flux de fonds, etc. | Oui |
- Spot
| Nom de la compétence | Objectif | Autorisation requise |
| bingx-spot-market | Données de marché : prix, profondeur, K-line,historique des trades, etc. | Incomplet |
| bingx-spot-trade | Opérations de trading : placement d’ordres, annulation d’ordres, requêtes d’ordres,ordres OCO, etc. | Oui |
| bingx-spot-account | Infos du compte : soldes, aperçu des actifs, transfert d’actifs, etc. | Oui |
| bingx-spot-wallet | Opérations du portefeuille : dépôt, retrait, historique des transferts, etc. | Oui |
- Coin-M perpétuels
| Nom de la compétence | Objectif | Autorisation requise |
| bingx-coinm-market | Données de marché : prix, profondeur, K-line, taux de financement, etc. | Incomplet |
| bingx-coinm-trade | Opérations de trading : placement d’ordres, annulation d’ordres, effet de levier, mode de l'actif, etc. | Oui |
- Copy trading
| Nom de la compétence | Objectif | Autorisation requise |
| bingx-copytrade-spot | Copy trading Spot : clôture des positions copiées, consultation des profits, etc. | Oui |
| bingx-copytrade-swap | Copy trading de Futures : clôture des positions, définition du TP/SL, paramétrage de commission, etc. | Oui |
- Gestion des comptes
| Nom de la compétence | Objectif | Autorisation requise |
| bingx-fund-account | Compte de fonds : consultation du solde, aperçu des actifs, transfert interne, etc. | Oui |
| bingx-sub-account | Gestion des sous-comptes : création / gel des sous-comptes, gestion des clés API , etc. | Oui |
| bingx-agent | Partenaire / Courtier : invitation d’utilisateurs, consultation des commissions, vérification des données partenaire, etc. | Oui |
- Futures standard
| Nom de la compétence | Objectif | Autorisation requise |
| bingx-standard-trade | Futures standard : consultation des positions, historique des ordres, solde, etc. | Oui |
Explication des autorisations
- Compétences ne nécessitant pas d’autorisation
Les compétences de données de marché suivants peuvent être utilisées sans configurer de clé API :
- bingx-swap-market (données de marché Futures perpétuels)
- bingx-spot-market (données de marché Spot)
- bingx-coinm-market (données de marché Futures standard Coin-M)
- Compétences nécessitant une autorisation
Toutes les autres compétences liées au trading et au compte nécessitent la configuration des variables d’environnement suivantes :
- BINGX_API_KEY — votre clé API
- BINGX_SECRET_KEY — votre clé secrète
La clé API est créée dans le Centre utilisateur de BingX → Gestion des API .
- Environnements d’exécution
| Environnement | Description | URL de base |
| prod-live | Production (live) | https://open-api.bingx.com |
| prod-vst | Démo (aucun fonds réel requis) | https://open-api-vst.bingx.com |
Pour les détails techniques complets sur la signature d’authentification, voir skills/references/authentication.md
Mécanisme de sécurité
- Confirmation des opérations
Dans l’environnement prod-live (production), toutes les opérations (placement d’ordres, annulation d’ordres, transferts, etc.) nécessitent que l’utilisateur saisisse CONFIRM avant exécution. Aucune confirmation n’est requise dans l’environnement de démonstration.
- Masquage des clés
L’IA masquera automatiquement les clés lors de leur affichage :
- Clé API : affiche les 5 premiers et les 4 derniers caractères. Par exemple : su1Qc...8akf
- Clé secrète : entièrement masquée, seuls les 5 derniers caractères sont affichés. Par exemple : ***...aws1
Scénarios d’utilisation courants
Une fois l’installation terminée, vous pouvez interagir directement avec l'IA de manière naturelle. Voici quelques exemples courants :
- Consultation des données de marché
| Consulter le prix actuel de BTC-USDT |
| Afficher les données K-line de la dernière heure pour ETH-USDT |
| Quel est le taux de financement actuel pour BTC-USDT ? |
- Opérations de trading
| Placer un ordre d’achat au marché sur BTC-USDT pour un montant de 0,01 |
| Placer un ordre de vente limite sur ETH au prix de 4 000 USDT pour un montant de 0,1 |
| Annuler tous les ordres ouverts pour BTC-USDT |
- Gestion des comptes
| Afficher le solde de mon compte Futures et mes positions en cours |
| Consulter le solde de mon compte Spot |
| Transférer 100 USDT de mon compte Spot vers mon compte Futures |
- Autres opérations
| Afficher la liste de mes sous-comptes |
| Consulter ma liste de parrainages de partenaire |
Processus multi-compétences
Plusieurs compétences peuvent être combinées pour effectuer des processus de trading complets :
- Processus de trading Futures
| swap-market (consulter les données de marché et la profondeur du BTC-USDT) ↓ swap-account (vérifier le solde du compte et la marge disponible) ↓ swap-trade (passer un ordre) |
- Processus de gestion des positions
| swap-account (consulter les positions en cours et le P&L) ↓ swap-market (consulter le dernier prix) ↓ swap-trade (clôturer ou ajuster une position) ↓ swap-account (confirmer le résultat de la clôture) |
- Processus de trading Spot
| spot-market (consulter le prix et la profondeur du marché Spot) ↓ spot-account (vérifier le solde du compte Spot) ↓ spot-trade (passer un ordre d'achat ou de vente) |
- Transfert d'actifs entre comptes
| spot-account (consulter le solde Spot) ↓ spot-account / fund-account (transférer des actifs vers le compte Futures) ↓ swap-trade (trader des Futures avec les fonds transférés) |
Structure des fichiers
Chaque module de compétence est composé de deux fichiers :
| skills/<skill-name>/ ├── SKILL.md # Description de l'utilisation par l'Agent └── api-reference.md # Documentation complète de l'API |
- SKILL.md : définit l'objectif de la compétence, un tableau de référence rapide, des exemples de code TypeScript, les règles d'interaction avec l'agent (autorisation, mécanisme de confirmation, etc.)
- api-reference.md : documentation complète des points d'entrée de l'API, incluant les détails des paramètres, les champs de réponse, des exemples JSON et les codes d'erreur.
La documentation de référence générale se trouve dans le dossier skills/references/ :
- authentication.md — Implémentation de la signature HMAC SHA256
- base-urls.md — Configuration des URL de base selon l'environnement
