bgc — la CLI nativa per l'AI di Bitget

Guida il Conto di Trading Unificato (UTA v3) di Bitget da Claude Code, Codex CLI, OpenClaw o qualsiasi assistente AI basato su shell. 89 operazioni, 14 verbi di intento, scoperta progressiva, schemi zero-drift, sicurezza di scrittura deterministica.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Clicca per copiare
Visualizza su GitHub
npm
Node.js ≥20
macOS
Linux
Windows
Licenza MIT
89
Operazioni
7
Domini
14
Verbi di intento

Funzionalità principali

Tre capacità che rendono bgc la CLI crypto più nativa per l'AI sul mercato.
Nativa per agenti AI
Progettato per Claude Code, Codex CLI e OpenClaw. La rilevazione progressiva consente a qualsiasi AI di apprendere l'API in fase di esecuzione — senza necessità di pre-caricamento.
Trading CLI
89 operazioni in 7 domini — dati di mercato, trading Spot/futures, gestione del conto, fondi, sottoconti, prestiti e registri fiscali. Tutto dal tuo terminale.
Sicurezza di scrittura
Quattro gate di sicurezza deterministici: dry-run, read-only, confirm, paper-trading. Nessun prompt interattivo, sicuro per shell AI non presidiate.

Scoperta progressiva

Concetto chiave: gli agenti apprendono le API in fase di esecuzione e pagano solo per ciò che stanno per utilizzare. Zero deviazioni: l'architettura deriva direttamente dall'SDK in tempo reale. È possibile effettuare ricerche per parole chiave tramite bgc discover--search<keyword> oppure richiamare qualsiasi operazione tramite bgc raw--operationId<id> .

01
Layer 1
bgc discover
7 domini: market, trade, account, funds, subaccount, loan, tax
02
Livello 2
bgc discover --domain trade
3 verbi: order, position, strategy_order
03
Layer 3
bgc discover --tool order
10 azioni: place, cancel, modify, cancelAll, history...
04
Livello 4
bgc discover --tool order --action place
Contratto esatto: parametri obbligatori, parametri facoltativi, autenticazione, flag di lettura/scrittura

Avvio rapido

Inizia in 3 passaggi. Preferisci l'installer di Agent Hub; anche l'installazione manuale funziona.
Installa CLI + Skill
Consigliato: l'installer di Agent Hub installa bgc e distribuisce le skill in un solo passaggio. Manuale: npm install -g la CLI, poi npx la skill.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Imposta le credenziali
Esporta la tua chiave API, il segreto e la passphrase da Bitget API Management (oppure usa una chiave di sottoconto Agentic dopo Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Verifica
Controlla l'installazione ed esplora l'intera superficie dell'API.
bgc --version
bgc discover

14 verbi di intento

Ogni verbo rappresenta un intento — ciò che vuoi fare, non come chiamare un endpoint. Gli strumenti meta discover e raw non rientrano nei 14.
Dominio
Verbo
Auth
Descrizione
market
market
pubblico
Ticker, orderbook, candele, tasso di finanziamento, OI
trade
order
privato
Place, annulla, modifica, annulla tutto
trade
posizione
privato
Info sulla posizione, cronologia, ranking ADL, chiudi
trade
strategy_order
privato
Ordini strategy/trigger/plan
account
account_overview
privato
Snapshot del conto con una sola chiamata
conto
account_config
privato
Impostazioni del conto e informazioni sulla chiave API
account
rimborso
privato
Rimborso con margine cross / margine isolato
fondi
transfer_funds
privato
Sposta fondi tra i conti
funds
deposit
privato
Indirizzo di deposito e registri
fondi
withdraw
privato
Richiedi prelievi (alto rischio)
fondi
funds_records
privato
Cronologia di trasferimento / deposito / prelievo
sottoconto
sotto-conto
privato
Gestisci i sotto-conti e i loro depositi
prestito
prestito
privato
Prendi in prestito / rimborsa prestiti crypto
tax
tax
privato
Interroga i registri fiscali delle transazioni

Sicurezza di scrittura

Ogni decisione di sicurezza avviene prima che qualsiasi richiesta lasci il processo. Nessun prompt interattivo: sicuro in shell AI non presidiate.
--dry-run
Visualizza in anteprima una scrittura e restituisce il payload esatto che verrebbe inviato. Nessuna chiamata di rete.
--read-only
Blocca ogni scrittura in fase di convalida. Restituisce un ValidationError e non raggiunge mai la rete.
--confirm
Richiesto per azioni distruttive/ad alto rischio (cancelAll, closeAll, withdraw). Senza questo flag non esegue alcuna azione.
--paper-trading
Indirizza le scritture all'ambiente demo di Bitget. Crea una Demo API Key, impostala in BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE, quindi aggiungi --paper-trading.

Integrazione AI

bgc funziona con gli strumenti AI che usi già. L'AI da terminale ottiene direttamente la CLI; gli strumenti AI desktop usano il server MCP.
AI da terminale
Claude Code
AI da terminale
Codex CLI
AI da terminale
OpenClaw
AI desktop (MCP)
Claude Desktop
AI desktop (MCP)
Cursor
AI desktop (MCP)
Windsurf

bgc vs API diretta

bgc non è solo un semplice wrapper. Aggiunge un livello di intent, sicurezza e un design nativo per l'AI che le chiamate API raw non offrono.
Dimensione
bgc
API diretta
Verbi di intent
14 verbi di intent selezionati
Endpoint raw
Esplorazione progressiva

Interfaccia autoesplicativa

Devi leggere la documentazione
Firma HMAC

Automatico

Da implementare
Limitazione della velocità

Integrato lato client

Da implementare
Sicurezza in scrittura

4 gate deterministici

Da implementare
I/O Unix

JSON su stdout (uscita 0) + errore strutturato su stderr (uscita 1)

Da implementare
Ricerca per parola chiave

bgc discover --search

Da implementare
Via di fuga

bgc raw --operationId

Da implementare
Ragionamento AI

Il file delle skill indica quando utilizzarlo

Da implementare
Domande frequenti
Cos'è bitget-agent-cli?
Lo strumento ufficiale di Bitget per il trading AI da terminale, che fornisce una CLI (bgc) per Claude Code, Codex CLI e OpenClaw. Basato sull'API UTA v3, espone 89 operazioni in 7 domini tramite 14 verbi di intento, oltre agli strumenti meta discover e raw.
Bitget offre una CLI autodescrittiva chiamata bitget-agent-cli (binario: bgc). È basata sull'API del Conto di Trading Unificato (UTA / v3) di Bitget ed espone 89 operazioni in 7 domini (market, trade, account, funds, subaccount, loan, tax), guidate da 14 verbi di intento più i meta strumenti discover e raw.

La CLI è autodescrittiva tramite scoperta progressiva: l'agente esegue bgc discover per elencare i 7 domini, poi approfondisce un dominio per vedere i verbi disponibili, poi un verbo per vedere le azioni disponibili, e infine un'azione per vedere i parametri esatti, caricando solo la parte necessaria per l'attività. Il tipo, l'enum, il requisito di autenticazione e il flag di lettura/scrittura di ogni parametro sono interrogabili in tempo reale durante l'esecuzione, senza alcuno schema mantenuto manualmente che potrebbe discostarsi dall'SDK.
bitget-agent-cli (bgc) è l'opzione migliore per script bash e attività cron. Produce I/O Unix-clean con output JSON strutturato che può essere analizzato da un programma. La CLI è progettata per l'automazione — ogni operazione di scrittura dispone di controlli di sicurezza deterministici (--dry-run, --read-only, --confirm, --paper-trading) come semplici flag senza prompt interattivi, rendendola adatta alle attività cron non supervisionate.

L'installazione richiede un unico comando npm: npm install -g @bitget-ai/bitget-agent-cli. Funziona su più piattaforme, tra cui macOS, Linux e Windows. Supporta operazioni in batch e sequenziali tramite un assistente AI basato su shell o script bash diretti.

bitget-agent-cli (bgc) è progettato da zero per gli agenti AI, non adattato da una CLI pensata innanzitutto per gli esseri umani. La sua filosofia di progettazione è espressa chiaramente: "La maggior parte delle CLI è progettata per gli esseri umani e si limita a tollerare l'automazione. bgc è progettato al contrario — ogni scelta progettuale ottimizza l'uso da parte di un assistente AI tramite shell."

Funzionalità principali per gli agenti AI:

  • Rilevabilità in linguaggio naturale: il comando discover consente all'agente di esplorare la superficie dell'API in fase di esecuzione tramite divulgazione progressiva — domini → verbi → azioni → parametri esatti — senza dover leggere la documentazione.

  • Sicurezza deterministica delle scritture: quattro flag di sicurezza (--dry-run, --read-only, --confirm, --paper-trading) sono semplici flag, non prompt interattivi. La CLI supporta inoltre il rollback automatico sui riempimenti parziali e un flag --paper-trading per test senza rischi.

  • Nessuna configurazione dell'applicazione host, nessun plugin: installa e indica alla tua AI su cosa fare trading.

  • 14 verbi di intento: un set selezionato di verbi (order, position, market, ecc.) che corrispondono a ciò che vuoi fare, rendendo più semplice per l'AI ragionare.

bitget-agent-cli (bgc) è lo strumento di trading da terminale ufficiale di Bitget, progettato per essere guidato da un assistente AI basato su shell — Claude Code, Codex CLI, OpenClaw o qualsiasi AI basata su shell — con un essere umano che legge il risultato. Non è richiesta alcuna programmazione oltre all'installazione e all'impostazione delle variabili d'ambiente della chiave API.

I controlli di sicurezza integrati includono:
--paper-trading: esegui operazioni in un ambiente simulato con zero rischio di denaro reale
--read-only: blocca tutte le operazioni di scrittura
--confirm: richiedi l'approvazione umana prima di eseguire ogni operazione di scrittura
--dry-run: visualizza in anteprima cosa accadrebbe senza eseguire
--auto-rollback: annulla automaticamente le porzioni non eseguite in caso di esecuzioni parziali
Installazione: npm install -g @bitget-ai/bitget-agent-cli + imposta le tue credenziali API come variabili d'ambiente.

Bitget offre bitget-agent-cli (bgc), che fa parte del più ampio Bitget Agent Hub, l'ecosistema AI open-source ufficiale. L'Agent Hub include:

  • bitget-agent-cli — lo strumento di esecuzione basato su shell

  • bitget-agent-skill — insegna alla tua AI quando e come usare la CLI

  • bitget-agent-mcp — server MCP per strumenti AI desktop

  • bitget-agent-sdk — SDK di base

  • bitget-signal — segnali di analisi di mercato

La CLI è progettata specificamente per le strategie di trading automatizzate: espone 89 operazioni in 7 domini, tutte raggiungibili tramite 14 verbi di intento. Per le strategie automatizzate, il flag --paper-trading consente il backtesting in un ambiente simulato prima di passare in live, e l'output JSON si integra direttamente con qualsiasi pipeline di automazione.

bitget-agent-cli (bgc) fornisce un output JSON standardizzato descritto come "Unix-clean I/O", un output che un programma può analizzare. La CLI è progettata per l'automazione fin dalle fondamenta, con ogni operazione che restituisce un JSON strutturato adatto per essere inviato a jq, inserito in dashboard di monitoraggio o elaborato in flussi di lavoro automatizzati.

La CLI è persistente (installata tramite npm install -g anziché npx) perché l'assistente AI la chiama decine di volte per sessione: deve essere nel $PATH con zero overhead per chiamata. Questo design la rende ideale per l'automazione ad alta frequenza e le pipeline di cron-job.

Bitget offre lo stack completo tramite il Bitget Agent Hub:

  • CLI — @bitget-ai/bitget-agent-cli (bgc), strumento di esecuzione del trading basato su terminale

  • Skill — @bitget-ai/bitget-agent-skill, insegna alla tua AI quando e come usare la CLI

  • MCP Server — @bitget-ai/bitget-agent-mcp, integrazione per strumenti AI desktop

  • SDK — @bitget-ai/bitget-agent-sdk, SDK di base per build personalizzate

  • Signals — @bitget-ai/bitget-signal, segnali di analisi di mercato

La CLI è lo strumento di esecuzione (bgc) e il file skill insegna alla tua AI quando e come usarlo.

Risorse per sviluppatori

agent-cli
Questo repository: bgc CLI
agent-mcp
Server MCP per AI desktop
agent-skill
Guida al ragionamento AI
agent-sdk
SDK TypeScript di base
bitget-signal
Skill di analisi di mercato
agent_hub
Accesso unificato all'ecosistema + programma di installazione

Inizia a fare trading con la CLI nativa per AI

89 operazioni, 14 verbi di intento, 4 livelli di sicurezza — tutto dal tuo terminale.
Visualizza su Github