agent_hub

Overview

Bitget Agent Hub is Bitget's official AI Agent toolkit, covering cryptocurrency and tokenized US stock trading — bringing 89 Bitget UTA v3 operations across trading and market analysis to Claude, Cursor, Codex, ChatGPT, and other AI agents.

Built for individual traders, quant developers, and anyone who wants to operate a crypto exchange through natural language.

This repository is the central entry point for the entire ecosystem. See individual package repos for detailed documentation.

Quick Start

What Do You Want to Do?

What do you want to do with AI?
|
+-- Let an AI Agent trade on Bitget for me
|     |
|     +-- Terminal AI (Claude Code / Codex CLI / OpenClaw)
|     |   -> install agent-cli + agent-skill
|     |
|     +-- Desktop AI (Claude Desktop / Cursor / Continue)
|         -> install agent-mcp
|
+-- Let an AI Agent monitor and analyze the market for me
|     -> install bitget-signal (no account, no API key)
|
+-- I'm a developer building my own Bitget AI tool
      -> install bitget-agent-sdk

Install with Your AI

The use-case tree above tells you which package you need. To set up the terminal tools in one shot, paste this into your terminal AI (Claude Code, Codex, OpenClaw):

Please run `npx @bitget-ai/bitget-agent-installer upgrade-all --target all` to set up the Bitget Agent Hub terminal tools (requires Node.js 20+), then help me verify the install.

This installs the bgc CLI plus the trading and market-signal skills, and deploys the skills to Claude Code, Codex, and OpenClaw. Desktop AI (Cursor, Claude Desktop, ChatGPT) uses bitget-agent-mcp instead — see Trading Tools. For per-package commands, rollback, and flags, see Installer below.

Ecosystem

Bitget Agent Hub consists of 5 core packages, each with a single responsibility. This repo also ships the bitget-agent-installer meta-tool that installs and upgrades them together.

Trading Tools (API Key Required)

Market Tools (No Account Needed)

All packages are MIT-licensed and free to use. They can be installed side by side without conflicts.

Installer

@bitget-ai/bitget-agent-installer is the ecosystem's meta-tool. One command installs, upgrades, rolls back, and deploys the Bitget Agent Hub packages into your AI tools — no installing each package and running each skill's setup by hand.

npx @bitget-ai/bitget-agent-installer

Run it with no arguments for an interactive menu, or pass a command directly (see below).

What It Manages

Desktop AI uses bitget-agent-mcp, which is registered in your MCP client's config rather than installed globally — set it up via the MCP package directly. bitget-agent-sdk is a library dependency and needs no separate install.

Why Use It

• One command for the whole ecosystem — install, upgrade, or roll back every package together.
• Always up to date — resolves each package's latest published version automatically; nothing to pin, so differing versions across packages just work.
• Skill deployment built in — wires skills straight into Claude Code, Codex, and OpenClaw via --target.
• Reversible — roll any package back to a previously published version.
• Safe to preview — --dry-run prints every command without running it.
• Lightweight — a single dependency-free script run with npx; auto-detects npm or pnpm.

Commands

Flags

• --target <tools> — where to deploy skills: claude, codex, openclaw, all (comma-separated; default claude)
• --dry-run — preview commands without executing them
• --version · --help

Examples

# Install everything and deploy skills to every supported AI tool
npx @bitget-ai/bitget-agent-installer upgrade-all --target all

# Update just the CLI to the latest version
npx @bitget-ai/bitget-agent-installer upgrade @bitget-ai/bitget-agent-cli

# Roll the CLI back to the pre-v3 release
npx @bitget-ai/bitget-agent-installer rollback @bitget-ai/bitget-agent-cli --to 1.2.0

# Deploy already-installed market-signal skills into Claude Code and Codex
npx @bitget-ai/bitget-agent-installer install @bitget-ai/bitget-signal --target claude,codex

# Preview an upgrade without changing anything
npx @bitget-ai/bitget-agent-installer upgrade-all --target all --dry-run

Trading Tools

Let an AI Agent Trade Bitget for You Automatically

Bitget Agent Hub's trading tools expose 89 UTA v3 operations through 14 curated intent verbs:

Choose Your AI Environment

Get Started

1. Create a Bitget API Key at bitget.com/api-management
2. Run the installer wizard or follow individual package docs
3. Verify installation by asking your AI: "What Bitget tools are available?"

First time? Create a Demo API Key and use --paper-trading to practice before touching real funds.

Market Tools

Let an AI Agent Monitor and Analyze the Market in Real Time

bitget-signal adds 5 market analysis skills — no Bitget account, no API key required:

Get Started

npx @bitget-ai/bitget-signal --target all

Restart your AI tool, then ask about market conditions.

Coming Next

Bitget-exclusive signals:

• top-trader-flow: Top copy-trading leader positioning
• derivatives-structure: Perp basis and term structure
• large-flow-detect: Whale-sized order detection

Architecture

graph TD
    subgraph Surfaces
        A[bitget-agent-cli<br/>Terminal AI]
        B[bitget-agent-mcp<br/>Desktop AI MCP]
        C[bitget-agent-skill<br/>AI Reasoning Guide]
    end
    
    subgraph Foundation
        D[bitget-agent-sdk<br/>TypeScript SDK]
    end
    
    subgraph MarketAnalysis
        E[bitget-signal<br/>5 Analysis Skills]
    end
    
    A --> D
    B --> D
    C --> A
    D --> F[Bitget UTA v3 API]
    E --> G[Public Market-Data MCP<br/>no API key]
    
    style D fill:#f9f,stroke:#333,stroke-width