Bitget Agent Hub

## Bitget Agent Hub — Official Bitget AI Trading and Market Data Ecosystem **The official open-source toolkit connecting Claude, Cursor, Codex, ChatGPT, and any MCP-compatible AI agent to your Bitget account and market data.** [Quick Start·](#quick-start)[Ecosystem·](#ecosystem)[Installer·](#installer)[Trading Tools·](#trading-tools)[Market Tools·](#market-tools)[Architecture·](#architecture)[Security·](#security)[FAQ **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. ``` `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` ``` 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](#faq)[Trading Tools. For per-package commands, rollback, and flags, see](#trading-tools)[Installerbelow. Bitget Agent Hub consists of 5 core packages, each with a single responsibility. This repo also ships the](#installer)[`bitget-agent-installer`meta-tool that installs and upgrades them together. All packages are MIT-licensed and free to use. They can be installed side by side without conflicts. `@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. Run it with no arguments for an interactive menu, or pass a command directly (see below). 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. - **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. - `--target <tools>`— where to deploy skills:`claude`,`codex`,`openclaw`,`all`(comma-separated; default`claude`) - `--dry-run`— preview commands without executing them - `--version`·`--help` ``` `# 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` ``` ### 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**: - Create a Bitget API Key at](#installer)[bitget.com/api-management - Run the installer wizard or follow individual package docs - 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. ### 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: ``` `npx @bitget-ai/bitget-signal --target all` ``` Restart your AI tool, then ask about market conditions. - **`top-trader-flow`**: Top copy-trading leader positioning - **`derivatives-structure`**: Perp basis and term structure - **`large-flow-detect`**: Whale-sized order detection ``` `graph TD subgraph Surfaces A](https://www.bitget.com/en/api-management)[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:2px style F fill:#bbf,stroke:#333,stroke-width:2px` ``` - **SDK**(`bitget-agent-sdk`): Foundation layer with 89 operations, HMAC signing, rate limiting - **CLI**(`bitget-agent-cli`): Terminal command-line tool built on SDK - **MCP**(`bitget-agent-mcp`): Desktop AI server built on SDK - **Skill**(`bitget-agent-skill`): Teaches terminal AI how to use CLI correctly - **Signal**(`bitget-signal`): Independent market analysis via a public, no-key market-data MCP service Based on Bitget UTA v3 API — 89 operations via 14 curated intent verbs: `strategy_order`is gated on the**trade**module — placing strategy orders is a trading capability an agent expects whenever trading is enabled; the`strategy`module's other operations remain reachable through`raw`. Plus meta tools:`discover`(explore operations) and`raw`(call any operation by`operationId`). Browse the live catalog anytime with`bgc discover`(or`discover`in any surface). - ✅**Never leaves your machine**: API keys read from environment variables only - ✅**Local signing**: All authenticated requests signed with HMAC-SHA256 in-process - ✅**No`.env`parsing**: Tools do not read`.env`files to prevent leakage - ✅**No proxy**: Direct connection to Bitget's official API - **`--read-only`**: Removes all write tools at startup — AI cannot place orders or transfers - **`--paper-trading`**: Routes to Bitget's Demo environment — no real funds involved - **Rate limiting**: Built-in client-side throttling prevents API abuse - Use Demo API Key first for testing - Start with`--read-only`mode to verify queries - Never commit credentials to version control - Rotate API keys every 90 days Per-package references — CLI flags, MCP client config, SDK API, signal skills — live in each package's own repo (see the[Ecosystemtable above). The live tool surface is always browsable with`bgc discover`(or`discover`in any surface). - **Bitget**:](#ecosystem)[bitget.com - **API documentation**:](https://www.bitget.com)[bitget.com/api-doc - **Model Context Protocol**:](https://www.bitget.com/api-doc/common/intro)[modelcontextprotocol.io - **All Bitget AI repos**:](https://modelcontextprotocol.io)[github.com/Bitget-AI Bitget Agent Hub is the**official open-source AI Agent ecosystem**from Bitget. It connects Bitget's cryptocurrency trading capabilities and real-time market data to AI agents like Claude, Cursor, Codex, and ChatGPT — covering 89 UTA v3 operations through 14 curated intent verbs, plus no-account-required market analysis skills. - **Terminal AI**(Claude Code, Codex) →`bitget-agent-cli`+`bitget-agent-skill` - **Desktop AI**(Claude Desktop, Cursor) →`bitget-agent-mcp` - **Market analysis only**→`bitget-signal`(no API key needed) - **Developer building custom tools**→`bitget-agent-sdk` ### Can I use AI to trade crypto automatically? Yes. Once installed, you can tell supported AI tools to "buy 0.1 BTC" or "open a BTC long at 10x leverage" and the AI will execute directly on your Bitget account. Use`--paper-trading`mode to rehearse safely. - Read from environment variables only - Never proxied through any server - Signed locally with HMAC-SHA256 - Never logged or written to disk Add`--read-only`at startup. All write tools are removed entirely — the AI cannot see or call them. Claude Desktop, Claude Code, Cursor, Codex CLI, Continue, Windsurf, ChatGPT Desktop, OpenClaw, and any MCP-compatible client. All packages are MIT-licensed and free to use.`bitget-signal`is maintained by Bitget and free to use — no API key, no account. Run`npx @bitget-ai/bitget-agent-installer`and choose upgrade, or: ``` `npx @bitget-ai/bitget-agent-installer upgrade-all --target all` ``` - **Report bugs or request features**:](https://github.com/Bitget-AI)[GitHub Issues - **Security issues**: email](https://github.com/Bitget-AI/agent_hub/issues)[security@bitget.com(please do not post publicly) ](https://github.com/Bitget-AI/agent_hub/blob/HEAD/mailto:security@bitget.com)[MIT License— Free for personal and commercial use. Attribution appreciated but not required. ⚠️**Risk Disclaimer**: Trading cryptocurrency and tokenized stocks carries substantial risk. You are solely responsible for any orders your AI agent places on your behalf. Always use`--read-only`and`--paper-trading`modes to rehearse safely before going live. Bitget Agent Hub is an official Bitget open-source project · Part of the Bitget AI ecosystem · Built for traders, developers, and AI enthusiasts Coinrule Agentic Trading MCP enables investors to create, backtest, execute, and manage trading agents through natural language across stocks, crypto and ETFs Remote MCP server for historical crypto & prediction-market data: search ~500K instruments, live market stats (OHLC, turnover, spreads, depth, slippage) and tick-data purchase. Keyless for catalog & stats; optional OAuth for account tools. Endpoint: https://cryptostruct.com/mcp Read-only MCP server for your Evibe investment portfolio + live market data (holdings, performance, dividends, benchmarks, screeners). Works with Claude & ChatGPT. Institutional squeeze scanner, options flow, IWM 0DTE, AI council verdicts. Pay per call in RLUSD on XRPL — no API keys. Agent Credit Bureau, signal marketplace, hiring protocol. Alpaca’s official MCP Server lets you trade stocks, ETFs, crypto, and options, run data analysis, and build strategies in plain English directly from your favorite LLM tools and IDEs Crypto exchange fee optimization with permanent 20-40% rebates. Affiliate revenue share for AI agent developers. Crypto data & trading MCP with 42+ tools: prices, DeFi, NFTs, Solana swaps Real-time crypto whale intelligence MCP server with 54 tools across 14 blockchains. No auth required. ### Deribit MCP with Claude Session injection 18 detection engines across crypto and US equities/ETFs return read-only market-risk verdicts — every one judged against realized outcomes in a public ledger, misses included.](https://github.com/Bitget-AI/agent_hub/blob/HEAD/LICENSE)