bgc — le CLI natif pour l’IA de Bitget

Pilotez le Unified Trading Account (UTA v3) de Bitget depuis Claude Code, Codex CLI, OpenClaw ou tout assistant IA basé sur le shell. 89 opérations, 14 verbes d’intention, découverte progressive, schémas sans dérive, sécurité d’écriture déterministe.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
cliquer pour copier
Voir sur GitHub
npm
Node.js ≥20
macOS
Linux
Windows
Licence MIT
89
Opérations
7
Domaines
14
Verbes d’intention

Fonctionnalités principales

Trois capacités qui font de bgc le CLI crypto le plus natif pour l’IA du marché.
Natif pour les agents IA
Conçu pour Claude Code, Codex CLI et OpenClaw. La découverte progressive permet à toute IA d’apprendre l’API à l’exécution — aucun préchargement nécessaire.
Trading via CLI
89 opérations réparties sur 7 domaines — données de marché, trading Spot/Futures, gestion de compte, fonds, sous-comptes, prêts et relevés fiscaux. Le tout depuis votre terminal.
Sécurité d’écriture
Quatre garde-fous de sécurité déterministes — dry-run, read-only, confirm, paper-trading. Aucun prompt interactif, sécurisé pour les shells IA sans supervision.

Découverte progressive

Idée centrale: les agents apprennent l’API au moment de l’exécution et ne paient que pour ce qu’ils s’apprêtent à utiliser. Zéro biais — l’architecture est dérivée directement du SDK en temps réel. Vous pouvez effectuer une recherche par mot-clé avec bgc discover--search<keyword>, ou appeler n’importe quelle opération avec bgc raw--operationId<id> .

01
Layer 1
bgc discover
7 domaines: market, trade, account, funds, subaccount, loan, tax
02
Layer 2
bgc discover --domain trade
3 verbes: order, position, strategy_order
03
Layer 3
bgc discover --tool order
10 actions: place, cancel, modify, cancelAll, history...
04
Couche 4
bgc discover --tool order --action place
Contrat exact: paramètres requis, paramètres facultatifs, authentification, flags lecture/écriture

Démarrage rapide

Démarrez en 3 étapes. Privilégiez l’installateur Agent Hub; l’installation manuelle fonctionne également.
Installer le CLI + Skill
Recommandé: l’installateur Agent Hub installe bgc et déploie les compétences en une seule étape. Manuel: installez le CLI avec npm install -g, puis exécutez la compétence avec npx.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Configurer les identifiants
Exportez votre clé API, votre clé secrète et votre phrase secrète depuis la gestion des API Bitget (ou utilisez une clé de sous-compte Agentic après Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Vérifier
Vérifiez l’installation et explorez l’ensemble de l’API.
bgc --version
bgc discover

14 verbes d’intention

Chaque verbe représente une intention — ce que vous souhaitez faire, et non comment appeler un endpoint. Les méta-outils discover et raw ne font pas partie des 14.
Domaine
Verbe
Authentification
Description
market
market
public
Tickers, carnet d’ordres, chandeliers, taux de financement, OI
trade
order
privé
Placer, annuler, modifier, tout annuler
trade
position
privé
Informations sur les positions, historique, rang ADL, clôture
trade
strategy_order
privé
Ordres de stratégie / déclenchement / planifiés
account
account_overview
privé
Snapshot de compte en un appel
compte
account_config
privé
Paramètres du compte et informations sur les clés API
account
remboursement
privé
Remboursement sur marge croisée / marge isolée
fonds
transfer_funds
privé
Transférer des fonds entre comptes
funds
deposit
privé
Adresse de dépôt et historique
fonds
withdraw
privé
Demander des retraits (haut risque)
fonds
funds_records
privé
Historique des transferts / dépôts / retraits
sous-compte
sous-compte
privé
Gérer les sous-comptes et leurs dépôts
prêt
prêt
privé
Emprunter / rembourser des Prêts Crypto
tax
fiscalité
privé
Consulter les relevés fiscaux des transactions

Sécurité d’écriture

Chaque décision de sécurité est prise avant qu’une requête ne quitte le processus. Aucun prompt interactif — sécurisé dans les shells IA sans supervision.
--dry-run
Prévisualise une écriture et renvoie la charge utile exacte qui serait envoyée. Aucun appel réseau.
--read-only
Bloque chaque écriture lors de la validation. Renvoie une ValidationError et n’atteint jamais le réseau.
--confirm
Requis pour les actions destructrices / à haut risque (cancelAll, closeAll, withdraw). N’a aucun effet sans lui.
--paper-trading
Dirige les écritures vers l’environnement de démonstration de Bitget. Créez une Demo API Key, configurez-la dans BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE, puis ajoutez --paper-trading.

Intégration IA

bgc fonctionne avec les outils d’IA que vous utilisez déjà. L’IA en terminal accède directement au CLI; les outils d’IA de bureau utilisent le serveur MCP.
IA en terminal
Claude Code
IA en terminal
Codex CLI
IA de terminal
OpenClaw
IA de bureau (MCP)
Claude Desktop
IA de bureau (MCP)
Cursor
IA de bureau (MCP)
Windsurf

bgc vs API directe

bgc n'est pas qu'un simple wrapper. Il ajoute une couche d'intention, de la sécurité et une conception native pour l'IA que les appels API bruts n'offrent pas.
Dimension
bgc
API directe
Verbes d'intention
14 verbes d'intention sélectionnés
Endpoints bruts
Découverte progressive

Interface auto-descriptive

Lecture de la documentation obligatoire
Signature HMAC

Automatique

Doit être implémenté
Limitation du débit

Intégré côté client

Doit être implémenté
Sécurité d'écriture

4 garde-fous déterministes

Doit être implémenté
E/S Unix

JSON sur stdout (code de sortie 0) + erreur structurée sur stderr (code de sortie 1)

Doit être implémenté
Recherche par mots-clés

bgc discover --search

Doit être implémenté
Solution de secours

bgc raw --operationId

Doit être implémenté
Raisonnement par IA

Le fichier de compétence indique quand l’utiliser

Doit être implémenté
FAQ
Qu’est-ce que bitget-agent-cli?
L’outil officiel de Bitget pour le trading IA depuis le terminal, fournissant un CLI (bgc) pour Claude Code, Codex CLI et OpenClaw. Construit sur l’API UTA v3, il expose 89 opérations réparties sur 7 domaines via 14 verbes d’intention, ainsi que les méta-outils discover et raw.
Bitget propose un CLI auto-descriptif nommé bitget-agent-cli (binaire: bgc). Il repose sur l’API Bitget Unified Trading Account (UTA / v3) et expose 89 opérations réparties sur 7 domaines (market, trade, account, funds, subaccount, loan, tax), pilotées par 14 verbes d’intention ainsi que par les méta-outils discover et raw.

Le CLI est auto-descriptif grâce à la découverte progressive: l’agent exécute bgc discover pour lister les 7 domaines, explore ensuite un domaine pour voir les verbes disponibles, puis un verbe pour voir les actions disponibles, puis une action pour voir les paramètres exacts — en ne chargeant que la partie nécessaire à la tâche. Le type, l’enum, l’exigence d’authentification et le flag de lecture/écriture de chaque paramètre peuvent être interrogés en direct à l’exécution, sans schéma maintenu manuellement susceptible de diverger du SDK.
bitget-agent-cli (bgc) est la meilleure option pour les scripts bash et les tâches cron. Il produit des E/S propres à Unix avec une sortie JSON structurée qu’un programme peut analyser. Le CLI est conçu pour l’automatisation — chaque opération d’écriture dispose de garde-fous déterministes (--dry-run, --read-only, --confirm, --paper-trading) sous forme de simples flags, sans invites interactives, ce qui le rend adapté aux tâches cron sans supervision.

L’installation se fait avec une seule commande npm: npm install -g @bitget-ai/bitget-agent-cli. Il fonctionne sur macOS, Linux et Windows. Il prend en charge les opérations par lots et séquentielles via un assistant IA basé sur un shell ou directement par script bash.

bitget-agent-cli (bgc) est conçu dès le départ pour les agents IA, et non adapté à partir d’un CLI pensé d’abord pour les humains. Sa philosophie de conception est clairement énoncée: « La plupart des CLI sont conçus pour les humains et ne font que tolérer l’automatisation. bgc est conçu à l’inverse — chaque choix de conception est optimisé pour un assistant IA qui l’utilise depuis un shell. »

Fonctionnalités clés pour les agents IA:

  • Découvrabilité en langage naturel: la commande discover permet à l’agent d’explorer la surface de l’API à l’exécution grâce à une divulgation progressive — domaines → verbes → actions → paramètres exacts — sans avoir à lire la documentation.

  • Sécurité déterministe des écritures: quatre indicateurs de sécurité (--dry-run, --read-only, --confirm, --paper-trading) sont de simples flags, et non des invites interactives. Le CLI prend également en charge l’annulation automatique des parties non exécutées lors d’exécutions partielles, ainsi qu’un flag --paper-trading pour tester sans risque.

  • Aucune configuration d’application hôte, aucun plugin: installez-le et indiquez à votre IA quoi trader.

  • 14 verbes d’intention: un ensemble sélectionné de verbes (order, position, market, etc.) correspondant à ce que vous souhaitez faire, ce qui facilite le raisonnement de l’IA.

bitget-agent-cli (bgc) est l’outil officiel de trading en terminal de Bitget, conçu pour être piloté par un assistant IA basé sur le shell — Claude Code, Codex CLI, OpenClaw ou toute IA basée sur le shell — avec une personne qui lit le résultat. Aucun codage n’est requis au-delà de l’installation et de la configuration des variables d’environnement de clé API.

Les contrôles de sécurité intégrés incluent:
--paper-trading: exécutez des trades dans un environnement simulé sans aucun risque lié à de l’argent réel
--read-only: bloque toutes les opérations d’écriture
--confirm: exige une approbation humaine avant l’exécution de chaque opération d’écriture
--dry-run: prévisualise ce qui se produirait sans exécuter l’opération
--auto-rollback: annule automatiquement les portions non exécutées lors d’exécutions partielles
Installation: npm install -g @bitget-ai/bitget-agent-cli + configurez vos identifiants API comme variables d’environnement.

Bitget propose bitget-agent-cli (bgc), qui fait partie de l’écosystème open source d’IA officiel Bitget Agent Hub. L’Agent Hub comprend:

  • bitget-agent-cli — l’outil d’exécution basé sur le shell

  • bitget-agent-skill — apprend à votre IA quand et comment utiliser le CLI

  • bitget-agent-mcp — serveur MCP pour les outils d’IA de bureau

  • bitget-agent-sdk — SDK de base

  • bitget-signal — signaux d’analyse de marché

Le CLI est spécifiquement conçu pour les stratégies de trading automatisées: il expose 89 opérations réparties sur 7 domaines, toutes accessibles via 14 verbes d’intention. Pour les stratégies automatisées, le flag --paper-trading permet d’effectuer des backtests dans un environnement simulé avant le passage en production, et la sortie JSON s’intègre directement à tout pipeline d’automatisation.

bitget-agent-cli (bgc) fournit une sortie JSON standardisée décrite comme « Unix-clean I/O » — une sortie qu’un programme peut analyser. Le CLI est conçu pour l’automatisation dès l’origine, chaque opération renvoyant un JSON structuré adapté au piping vers jq, à l’alimentation de tableaux de bord de surveillance ou au traitement dans des workflows automatisés.

Le CLI est persistant (installé via npm install -g plutôt que npx), car l’assistant IA l’appelle des dizaines de fois par session — il doit être dans $PATH sans aucune surcharge par appel. Cette conception le rend idéal pour l’automatisation à haute fréquence et les pipelines de tâches cron.

Bitget propose une pile complète via le Bitget Agent Hub:

  • CLI — @bitget-ai/bitget-agent-cli (bgc), outil d’exécution du trading en terminal

  • Skill — @bitget-ai/bitget-agent-skill, apprend à votre IA quand et comment utiliser le CLI

  • MCP Server — @bitget-ai/bitget-agent-mcp, intégration aux outils d’IA de bureau

  • SDK — @bitget-ai/bitget-agent-sdk, SDK de base pour les développements personnalisés

  • Signals — @bitget-ai/bitget-signal, signaux d’analyse de marché

Le CLI est l’outil d’exécution (bgc), et le fichier de compétences apprend à votre IA quand et comment l’utiliser.

Ressources pour développeurs

agent-cli
Ce dépôt — bgc CLI
agent-mcp
Serveur MCP pour les applications d’IA sur ordinateur
agent-skill
Guide de raisonnement IA
agent-sdk
SDK TypeScript de base
bitget-signal
Compétence d’analyse de marché
agent_hub
Point d’accès unifié à l’écosystème + installateur

Commencez à trader avec un CLI natif pour l’IA

89 opérations, 14 verbes d’intention, 4 niveaux de sécurité — le tout depuis votre terminal.
Voir sur GitHub