bgc — die AI-native CLI für Bitget

Steuern Sie Bitgets Unified Trading Account (UTA v3) über Claude Code, Codex CLI, OpenClaw oder einen beliebigen Shell-basierten KI-Assistenten. 89 Vorgänge, 14 Intent-Verben, progressive Erkennung, Zero-Drift-Schemas, deterministische Schreibsicherheit.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Zum Kopieren klicken
Auf GitHub ansehen
npm
Node.js ≥20
macOS
Linux
Windows
MIT License
89
Operationen
7
Domains
14
Intent-Verben

Kernfunktionen

Drei Fähigkeiten, die bgc zur AI-nativsten Krypto-CLI auf dem Markt machen.
AI-Agent-nativ
Entwickelt für Claude Code, Codex CLI und OpenClaw. Die progressive Entdeckung ermöglicht jeder AI, die API zur Laufzeit zu erlernen — kein vorheriges Laden erforderlich.
CLI-Trading
89 Operationen in 7 Domains — Marktdaten, Spot-/Futures-Trading, Kontoverwaltung, Assets, Unterkonten, Kredite und Steueraufzeichnungen. Alles über Ihr Terminal.
Schreibsicherheit
Vier deterministische Sicherheitsstufen — dry-run, read-only, confirm, paper-trading. Keine interaktiven Eingabeaufforderungen, sicher für unbeaufsichtigte KI-Shells.

Progressive Erkennung

Kernprinzip: Der Agent lernt die API zur Laufzeit und bezahlt nur für Inhalte, die er demnächst verwendet. Keine Abweichungen – die Architektur wird direkt in Echtzeit aus dem SDK abgeleitet. Schlüsselwörter können über bgc discover--search<keyword> gesucht oder beliebige Vorgänge über bgc raw--operationId<id> aufgerufen werden.

01
Layer 1
bgc discover
7 Domains: market, trade, account, funds, subaccount, loan, tax
02
Layer 2
bgc discover --domain trade
3 Verben: order, position, strategy_order
03
Layer 3
bgc discover --tool order
10 Aktionen: place, cancel, modify, cancelAll, history...
04
Layer 4
bgc discover --tool order --action place
Exakter Vertrag: erforderliche Parameter, optionale Parameter, Authentifizierung, Lese-/Schreib-Flags

Schnellstart

Starten Sie in 3 Schritten. Bevorzugen Sie den Agent-Hub-Installer; auch die manuelle Installation funktioniert.
CLI + Skill installieren
Empfohlen: Der Agent-Hub-Installer installiert bgc und stellt Skills in einem Schritt bereit. Manuell: Installieren Sie die CLI mit npm install -g und führen Sie anschließend den Skill mit npx aus.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Zugangsdaten festlegen
Exportieren Sie Ihren API-Key, Secret und Ihre Passphrase über Bitget API Management (oder verwenden Sie nach Hub OAuth einen Agentic-Unterkonto-Key).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Überprüfen
Überprüfen Sie die Installation und erkunden Sie den vollständigen API-Umfang.
bgc --version
bgc discover

14 Intent-Verben

Jedes Verb steht für eine Absicht — was Sie tun möchten, nicht wie ein Endpunkt aufgerufen wird. Die Meta-Tools discover und raw gehören nicht zu den 14 Verben.
Bereich
Verb
Authentifizierung
Beschreibung
market
market
öffentlich
Ticker, Orderbuch, Candles, Finanzierungsrate, OI
traden
order
privat
Platzieren, stornieren, ändern, alle stornieren
traden
Position
Privat
Positionsinformationen, Verlauf, ADL-Rang, schließen
trade
strategy_order
privat
Strategie-/Trigger-/Plan-Orders
account
account_overview
Privat
Konto-Snapshot mit einem Aufruf
account
account_config
Privat
Kontoeinstellungen und API-Key-Informationen
account
Rückzahlung
privat
Cross-Margin- / Isolated-Margin-Rückzahlung
Assets
transfer_funds
privat
Assets zwischen Konten übertragen
funds
deposit
privat
Einzahlungsadresse und Aufzeichnungen
Assets
withdraw
Privat
Auszahlungen anfordern (risikoreich)
Assets
funds_records
privat
Überweisungs- / Einzahlungs- / Auszahlungshistorie
Unterkonto
Unterkonto
Privat
Unterkonten und deren Einzahlungen verwalten
Kredit
Kredit
privat
Krypto-Kredite aufnehmen / zurückzahlen
tax
Steuern
Privat
Steueraufzeichnungen für Transaktionen abfragen

Schreibsicherheit

Jede Sicherheitsentscheidung wird getroffen, bevor eine Anfrage den Prozess verlässt. Keine interaktiven Eingabeaufforderungen — sicher in unbeaufsichtigten KI-Shells.
--dry-run
Zeigt eine Schreiboperation in der Vorschau an und gibt die exakte Payload zurück, die gesendet würde. Kein Netzwerkaufruf.
--read-only
Blockiert jeden Schreibvorgang bereits bei der Validierung. Gibt einen ValidationError zurück und erreicht nie das Netzwerk.
--confirm
Erforderlich für destruktive / risikoreiche Aktionen (cancelAll, closeAll, withdraw). Ohne dieses Flag erfolgt keine Ausführung.
--paper-trading
Leitet Schreiboperationen an die Bitget-Demo-Umgebung weiter. Erstellen Sie einen Demo API-Key, legen Sie ihn in BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE fest und fügen Sie anschließend --paper-trading hinzu.

AI-Integration

bgc funktioniert mit den KI-Tools, die Sie bereits verwenden. Terminal-KI erhält die CLI direkt; Desktop-KI-Tools nutzen den MCP-Server.
Terminal-KI
Claude Code
Terminal-KI
Codex CLI
Terminal-AI
OpenClaw
Desktop-AI (MCP)
Claude Desktop
Desktop-KI (MCP)
Cursor
Desktop-AI (MCP)
Windsurf

bgc vs. Direct API

bgc ist nicht nur ein einfacher Wrapper. Es fügt einen Intent-Layer, Sicherheit und ein KI-natives Design hinzu, das reine API-Aufrufe nicht bieten.
Dimension
bgc
Direkte API
Intent Verbs
14 kuratierte Intent-Verben
Ursprüngliche Endpunkte
Progressive Discovery

Selbstbeschreibende Oberfläche

Dokumentation muss gelesen werden
HMAC-Signierung

Automatisch

Muss implementiert werden
Rate Limiting

Clientseitig integriert

Muss implementiert werden
Write-Safety

4 deterministische Gates

Muss implementiert werden
Unix-E/A

JSON über stdout (Exit 0) + strukturierter Fehler über stderr (Exit 1)

Muss implementiert werden
Keyword Search

bgc discover --search

Muss implementiert werden
Notfallausstieg

bgc raw --operationId

Muss implementiert werden
AI Reasoning

Skill-Datei zeigt, wann diese Funktion verwendet werden soll

Muss implementiert werden
FAQ
Was ist bitget-agent-cli?
Bitgets offizielles Terminal-AI-Trading-Tool mit einer CLI (bgc) für Claude Code, Codex CLI und OpenClaw. Es basiert auf der UTA-v3-API und stellt 89 Operationen in 7 Domains über 14 Intent-Verben sowie die Meta-Tools discover und raw bereit.
Bitget bietet eine selbstbeschreibende CLI namens bitget-agent-cli (Binärdatei: bgc). Sie basiert auf der Bitget Unified Trading Account (UTA / v3) API und stellt 89 Vorgänge in 7 Bereichen (market, trade, account, funds, subaccount, loan, tax) bereit, die über 14 Intent-Verben sowie die Meta-Tools discover und raw zugänglich sind.

Die CLI ist durch progressive Offenlegung selbstbeschreibend: Der Agent führt bgc discover aus, um die 7 Bereiche aufzulisten, untersucht dann einen Bereich, um verfügbare Verben zu sehen, anschließend ein Verb, um verfügbare Aktionen zu sehen, und danach eine Aktion, um die exakten Parameter anzuzeigen — dabei wird nur der für die Aufgabe benötigte Abschnitt geladen. Typ, Enum, Authentifizierungsanforderung sowie Lese-/Schreib-Flag jedes Parameters können zur Laufzeit live abgefragt werden, ohne manuell gepflegtes Schema, das vom SDK abweichen könnte.
bitget-agent-cli (bgc) ist die beste Option für bash-Skripte und cron-Jobs. Es erzeugt Unix-saubere I/O mit strukturiertem JSON-Output, den ein Programm parsen kann. Die CLI ist für Automatisierung entwickelt — jede Schreiboperation verfügt über deterministische Sicherheitsmechanismen (--dry-run, --read-only, --confirm, --paper-trading) als reine Flags ohne interaktive Eingabeaufforderungen, wodurch sie sich für unbeaufsichtigte cron-Jobs eignet.

Die Installation erfolgt mit einem einzigen npm-Befehl: npm install -g @bitget-ai/bitget-agent-cli. Sie funktioniert plattformübergreifend unter macOS, Linux und Windows. Sie unterstützt Batch- und sequenzielle Operationen über einen Shell-basierten AI Assistant oder direktes bash-Scripting.

bitget-agent-cli (bgc) wurde von Grund auf für AI Agents entwickelt und nicht aus einer auf Menschen ausgerichteten CLI angepasst. Seine Designphilosophie wird direkt formuliert: „Die meisten CLIs werden für Menschen entwickelt und tolerieren Automatisierung lediglich. bgc wurde genau umgekehrt entwickelt — jede Designentscheidung ist darauf optimiert, dass ein AI Assistant es über eine Shell steuert.“

Wichtige Funktionen für AI Agents:

  • Entdeckbarkeit in natürlicher Sprache: Der Befehl discover ermöglicht es dem Agent, die API-Oberfläche zur Laufzeit durch progressive Offenlegung zu erkunden — Domains → Verben → Aktionen → exakte Parameter — ohne Dokumentation lesen zu müssen.

  • Deterministische Schreibsicherheit: Vier Sicherheits-Flags (--dry-run, --read-only, --confirm, --paper-trading) sind reine Flags und keine interaktiven Eingabeaufforderungen. Die CLI unterstützt außerdem automatisches Rollback bei Teilausführungen sowie das Flag --paper-trading für risikofreie Tests.

  • Keine Konfiguration einer Host-Anwendung, keine Plugins: Installieren Sie die CLI und teilen Sie Ihrer AI mit, was sie traden soll.

  • 14 Intent-Verben: Eine kuratierte Auswahl an Verben (order, position, market usw.), die abbilden, was Sie tun möchten, sodass die AI dies einfach nachvollziehen kann.

bitget-agent-cli (bgc) ist das offizielle Terminal-Trading-Tool von Bitget, das dafür entwickelt wurde, von einem Shell-basierten KI-Assistenten — Claude Code, Codex CLI, OpenClaw oder einer beliebigen Shell-basierten KI — gesteuert zu werden, während ein Mensch das Ergebnis prüft. Über die Installation und das Setzen von API-Key-Umgebungsvariablen hinaus ist keine Programmierung erforderlich.

Integrierte Sicherheitskontrollen umfassen:
--paper-trading: Trades in einer simulierten Umgebung ohne Risiko für echtes Geld ausführen
--read-only: Alle Schreibvorgänge blockieren
--confirm: Vor der Ausführung jedes Schreibvorgangs eine menschliche Freigabe verlangen
--dry-run: Vorschau dessen anzeigen, was passieren würde, ohne es auszuführen
--auto-rollback: Nicht ausgeführte Teile bei Teilausführungen automatisch stornieren
Installation: npm install -g @bitget-ai/bitget-agent-cli + Ihre API-Zugangsdaten als Umgebungsvariablen festlegen.

Bitget bietet bitget-agent-cli (bgc), das Teil des umfassenderen Bitget Agent Hub ist — des offiziellen Open-Source-KI-Ökosystems. Der Agent Hub umfasst:

  • bitget-agent-cli — das Shell-basierte Ausführungstool

  • bitget-agent-skill — vermittelt Ihrer KI, wann und wie sie die CLI verwenden soll

  • bitget-agent-mcp — MCP-Server für Desktop-KI-Tools

  • bitget-agent-sdk — Basis-SDK

  • bitget-signal — Markanalyse-Signale

Die CLI wurde speziell für automatisierte Trading-Strategien entwickelt: Sie stellt 89 Vorgänge in 7 Bereichen bereit, die alle über 14 Intent-Verben erreichbar sind. Für automatisierte Strategien ermöglicht das Flag --paper-trading Backtesting in einer simulierten Umgebung, bevor Sie live gehen, und die JSON-Ausgabe lässt sich direkt in jede Automatisierungspipeline integrieren.

bitget-agent-cli (bgc) bietet standardisierte JSON-Ausgaben, die als „Unix-clean I/O“ bezeichnet werden — Ausgaben, die ein Programm parsen kann. Die CLI wurde von Grund auf für die Automatisierung entwickelt, wobei jeder Vorgang strukturiertes JSON zurückgibt, das sich zum Weiterleiten an jq, Einspeisen in Monitoring-Dashboards oder Verarbeiten in automatisierten Workflows eignet.

Die CLI ist dauerhaft installiert (über npm install -g statt npx), da der KI-Assistent sie pro Sitzung Dutzende Male aufruft — sie muss ohne Overhead pro Aufruf im $PATH verfügbar sein. Dieses Design macht sie ideal für Hochfrequenzautomatisierung und Cronjob-Pipelines.

Bitget bietet den vollständigen Stack über den Bitget Agent Hub:

  • CLI — @bitget-ai/bitget-agent-cli (bgc), terminalbasiertes Trading-Ausführungstool

  • Skill — @bitget-ai/bitget-agent-skill, vermittelt Ihrer KI, wann und wie sie die CLI verwenden soll

  • MCP-Server — @bitget-ai/bitget-agent-mcp, Integration für Desktop-KI-Tools

  • SDK — @bitget-ai/bitget-agent-sdk, Basis-SDK für individuelle Entwicklungen

  • Signale — @bitget-ai/bitget-signal, Marktanalyse-Signale

Die CLI ist das Ausführungstool (bgc), und die Skill-Datei vermittelt Ihrer KI, wann und wie sie es verwenden soll.

Entwicklerressourcen

agent-cli
Dieses Repository – bgc CLI
agent-mcp
MCP-Server für Desktop-AI
agent-skill
Leitfaden für AI-Inferenz
agent-sdk
TypeScript-Basis-SDK
bitget-signal
Skill für Marktanalyse
agent_hub
Einheitlicher Einstiegspunkt ins Ökosystem + Installer

Starten Sie mit KI-nativer CLI ins Trading

89 Operationen, 14 Intent-Verben, 4 Sicherheitsebenen — alles über Ihr Terminal.
Auf GitHub ansehen