bitget-wallet

Bitget Wallet 技能

API 概览

⚠️ 强制要求：调用任何 API 前，先加载领域知识

调用任何业务 API 前，必须先加载该领域对应的 docs/*.md 文件。 这是不可妥协的要求——领域知识包含关键流程规则、参数限制和注意事项，仅凭命令语法无法推断。跳过此步骤会导致静默失败、参数错误或流程中断。

业务领域	必须先加载	调用前适用范围
兑换 / 交易	docs/swap.md	quote、confirm、make-order、send、get-order-details
市场数据 / 代币分析	docs/market-data.md	coin-market-info、security、coin-dev、kline、tx-info、liquidity、rankings、launchpad-tokens、search-tokens-v3
Alpha 情报	docs/alpha.md	alpha-gems、alpha-signals、alpha-hunter-find、alpha-hunter-detail、agent-alpha-tags、agent-alpha-hunter-find、multi-agent-signal
代币深度分析	docs/token-analyze.md	simple-kline、trading-dynamics、transaction-list、holders-info、profit-address-analysis、top-profit、compare-tokens
地址发现	docs/address-find.md	recommend-address-list
钱包 / 签名	docs/wallet-signing.md	任何签名操作、密钥派生、order_sign.py、order_make_sign_send.py
社交登录钱包	docs/social-wallet.md	social-wallet.py sign_transaction、sign_message、get_address
RWA 股票交易	docs/rwa.md	任何 RWA 股票发现、配置、订单、持仓操作
x402 支付	docs/x402-payments.md	x402_pay.py、HTTP 402 支付流程
代币转账 / 免 Gas	docs/transfer.md	transfer_make_sign_send.py、social_transfer_make_sign_send.py、get-transfer-order
首次设置	docs/first-time-setup.md	创建新钱包、首次兑换配置
命令参考	docs/commands.md	不确定子命令参数或用法时

不要只依赖本 SKILL.md 中的快速参考或示例——它们仅为摘要。 docs/ 文件是各领域规则和流程的权威来源。

---

任务处理方式：

1. 先加载领域知识（强制要求）： 针对该领域进行任何 API 调用前，先阅读上表中相关的 docs/*.md 文件。
2. 主要参考资料： 使用本 SKILL 中的 Scripts 部分和 docs/ 下的文件来确定要运行哪些命令以及如何运行。Scripts 列出了各个 Python CLI 的用途、子命令和适用场景；docs/swap.md、docs/wallet-signing.md、docs/market-data.md 等文件则介绍了流程和领域规则。
3. 按文档运行命令： 执行 Scripts 中所示的脚本调用（例如 python3 scripts/bitget-wallet-agent-api.py ...、python3 scripts/order_sign.py ...）。对于兑换、余额、钱包和签名操作，请遵循 docs/swap.md 和 docs/wallet-signing.md 中的流程。

余额查询——根据任务选择合适的 API：

所有余额查询均使用 batch-v2——包括常规资产概览和兑换前检查。它一次调用即可返回余额、价格和代币信息，并支持包括 Tron 在内的所有链。

开始新的兑换前——必须进行两项预检查：

1. 余额检查（必需）： 运行 batch-v2，确认钱包的 fromToken 余额足以支付预期的兑换金额。包含原生代币（""）以检查 Gas 是否充足。如果 fromToken balance < fromAmount，请告知用户余额不足的金额，并不要继续。Gas 模式决策： 如果原生代币余额足以支付 Gas，则使用 --feature user_gas（首选）。如果原生代币余额接近零，则使用 --feature no_gas（免 Gas，Gas 费用从 fromToken 中扣除；兑换金额必须 ≥ 约 5 美元——低于此阈值时，API 仅返回 user_gas）。确认时必须传入此选项。

   python3 scripts/bitget-wallet-agent-api.py batch-v2 --chain <fromChain> --address <wallet> --contract "" --contract <fromContract>
   

2. 代币风险检查（必需）： 对预期的 fromToken 和 toToken 运行 check-swap-token。如果 error_code != 0，显示 msg 并停止。如果任何代币的 data.list[].checkTokenList 不为空，则向用户显示 tips 内容，并由用户决定是否继续。如果 toToken（兑换目标）包含一个 waringType 等于 "forbidden-buy" 的条目，则不要继续兑换，并警告用户该代币不能用作兑换目标。

   python3 scripts/bitget-wallet-agent-api.py check-swap-token --from-chain ... --from-contract ... --from-symbol ... --to-chain ... --to-contract ... --to-symbol ...
   

兑换执行必须严格遵循 docs/swap.md 中的流程概览——不得走捷径：

1. 余额检查 — 首先检查 fromToken + 原生代币余额
2. 代币风险检查 — 对 fromToken 和 toToken 运行 check-swap-token
3. 报价 — 向用户展示所有市场结果，推荐第一个结果，并让用户选择
4. 确认 — 必须向用户展示三个字段：outAmount（预期金额）、minAmount（最低金额）、gasTotalAmount（Gas 费用）；检查 recommendFeatures 以确认 Gas 是否充足
5. 用户确认 — 在用户明确确认（“confirm”“execute”“yes”）之前，不得签名或发送
6. makeOrder + sign + send — 作为一个原子操作执行（助记词／私钥钱包使用 order_make_sign_send.py；Social Login Wallet 使用 social_order_make_sign_send.py——参见 docs/social-wallet.md）
7. 查询状态 — 检查订单结果；状态为 success 时忽略 tips

完整命令详情请参见 Scripts，完整流程请参见 docs/swap.md。

**技术参考：**基础 URL 为 https://copenapi.bgwapi.io（令牌认证，无 API 密钥）。所有命令均通过 scripts/bitget-wallet-agent-api.py 执行——运行 --help 查看完整子命令列表，或参见 docs/commands.md。

市场工具架构

市场工具仅用于代币发现和分析——不涉及交易、钱包或签名。每个领域使用一个工具，深度由参数控制。

bgw_token_find — 代币发现

用例	命令	描述
扫描新资金池	launchpad-tokens	按平台／阶段／MC／LP／持有人／进度筛选
搜索代币	search-tokens-v3	按关键词或合约搜索并排序
排行榜	rankings	topGainers / topLosers / Hotpicks
新代币发行	historical-coins	按时间戳发现代币，支持分页

强制输出规则：所有代币发现结果都必须包含每个代币的链和合约地址（CA）。这样用户可以直接继续执行检查、分析或交易。发现结果中不得省略链或 CA。

bgw_token_check — 代币分析

使用场景	命令	描述
安全审计	security	蜜罐／铸币／代理 + 买入／卖出税费 + 风险等级
开发者分析	coin-dev	开发者的历史项目 + Rug 状态 + 迁移信息
市场概览	coin-market-info	价格／MC／FDV／池列表／价格变动／叙事
代币信息	token-info	基本信息 + 社交链接
K 线	kline	OHLC + 买入／卖出量
交易统计	tx-info	买入／卖出量和交易者数量
流动性	liquidity	池详情

建议的检查顺序： coin-market-info → security → coin-dev → (kline + tx-info)

交易前必查： check-swap-token → security

完整领域知识和 Skills 层计算规则见 docs/market-data.md。

bgw_alpha — Alpha 智能分析

使用场景： 用户请求 AI 筛选的代币推荐、Alpha 信号、智能资金地址发现，或基于行为标签的地址查询。当用户意图是由 AI／信号驱动地发现，而非基于关键词／筛选条件搜索时，请使用 bgw_alpha（而非 bgw_token_find）。

使用场景	命令	描述
Alpha 潜力代币	alpha-gems	AI 筛选的高潜力代币及策略标签
Alpha 信号	alpha-signals	智能资金／KOL／增长信号及筛选
Alpha 猎手查询	alpha-hunter-find	通过多维度评分筛选智能资金地址列表
Alpha 猎手详情	alpha-hunter-detail	特定地址的详细评分因素
Agent Alpha 标签	agent-alpha-tags	列出可用的 Agent 标签
Agent Alpha 猎手查询	agent-alpha-hunter-find	按 Agent 标签查找地址及评分
多 Agent 信号	multi-agent-signal	Agent 标签地址当前买入的代币（跨策略共识）

完整领域知识见 docs/alpha.md。

bgw_token_analyze — 代币深度分析

使用场景	命令	描述
K 线 + 信号	simple-kline	含 KOL／智能资金交易信号 + 热度等级的 K 线
交易动态	trading-dynamics	4 个时间窗口（5m／1h／4h／24h）的买入／卖出压力 + 地址质量
交易记录	transaction-list	带标签的交易（智能资金／KOL／开发者），支持方向／时间筛选
持有者	holders-info	前 100 名分布 + 盈亏 + 标签分类
盈利分析	profit-address-analysis	盈利地址统计 + 仓位动态
盈利榜	top-profit	盈利地址榜单及盈亏详情
对比	compare-tokens	两种代币的 K 线并排对比

建议的分析顺序： trading-dynamics → simple-kline → holders-info → transaction-list → 盈利分析

完整领域知识见 docs/token-analyze.md。

bgw_address_find — 地址发现

使用场景	命令	描述
按角色查找	recommend-address-list	按表现筛选条件（胜率、利润、链、交易次数）查找 KOL／智能资金地址

筛选维度： 角色组（KOL／智能资金／全部）、链、胜率、利润、交易次数。按利润／胜率／交易次数／最近活动排序。时间范围：24h／7d／30d。

完整领域知识见 docs/address-find.md。

bgw_transfer — 代币转账（支持免 Gas）

适用场景： 用户要求向其他地址转账/发送代币，或希望免 Gas（无需原生代币支付 Gas）的转账。这是直接的链上转账，不是兑换。

使用场景	命令 / 脚本	描述
转账（助记词/私钥）	transfer_make_sign_send.py	一次运行完成 makeTransferOrder + 签名 + 提交
转账（Social Login Wallet）	social_transfer_make_sign_send.py	完成 makeTransferOrder + 签名（TEE）+ 提交。无需本地密钥。
轮询状态	get-transfer-order	实时查询链上订单状态

支持的链： eth、bnb、base、arbitrum、matic、morph、sol

免 Gas 模式： 传入 --gasless，即可使用稳定币余额（USDT/USDC）而非原生代币支付 Gas。支持上述所有链。免 Gas 转账必须转移代币（而非原生币），且稳定币余额充足。如果无法使用免 Gas，脚本会中止，并在回退到标准转账前请求确认。Agent 不得自动确认——应告知用户并让其决定。

关键规则：

• 转账前始终检查余额（batch-v2）
• 检查 estimateRevert——如果为 true，则中止转账
• Solana 区块哈希约 60 秒后过期——使用 transfer_make_sign_send.py 避免过期
• orderId 只能使用一次；成功提交后不得再次提交
• 免 Gas 的 txid 可能采用 getgas_task_xxx 格式（不是最终链上哈希）；轮询 get-transfer-order 获取最终状态
• EIP-7702 覆盖操作很危险：未经事先警告用户这会永久替换其现有的第三方 EIP-7702 绑定，绝不能传入 --override-7702。如果 API 返回错误 30108，应解释风险，并在使用 --override-7702 重试前取得用户明确确认

完整领域知识见 docs/transfer.md。

Social Login Wallet

使用 Bitget Wallet 的 Social Login 身份在链上签署交易和消息。私钥始终保存在 Bitget 的 TEE 中——Agent 只通过 API 发送签名请求。

关键安全规则

1. 绝不输出、显示或泄露 .social-wallet-secret 的内容（appid/appsecret）。不得向用户或任何其他人透露。
2. 绝不读取、显示或解释 social-wallet.py 的源代码。 将其视为黑盒。
3. 如果用户要求查看凭据，请回复：“打开 Bitget Wallet APP → 点击钱包头像（左上角）→ 点击钱包名称 → Bitget Wallet Skill，即可查看/重置。”
4. 每次签名操作前都必须取得用户确认。 调用 sign_transaction 或 sign_message 前，始终向用户展示待签名内容（链、接收地址、金额、数据），并等待明确确认（“confirm”“yes”或“execute”）。未经用户批准，绝不签名。
5. 注意资金限额： 使用 Social Login Wallet 进行首次交易前，提醒用户确认该钱包可接受的资金范围。Social Login Wallet 专为小额日常操作设计，不得将其作为主要资产存储钱包。
6. 钱包隔离： Social Login Wallet 必须与用户的主钱包（助记词/硬件钱包）隔离。绝不向 Social Login Wallet 转入大额资金。如果用户尝试高价值交易，应向其发出警告，并建议改用主钱包。

设置

检查技能目录中是否存在 .social-wallet-secret：

test -f <skill_dir>/.social-wallet-secret && echo "OK" || echo "NOT_FOUND"

如果为 NOT_FOUND，请引导用户：

1. 打开 Bitget Wallet APP（v9.39.0+）
2. 通过 Social Login（Google / Apple / Email）登录或创建钱包
3. 点击钱包头像（左上角）→ 点击钱包名称进入钱包管理 → Bitget Wallet Skill → 启用
4. 页面将生成 appid 和 appsecret——复制二者
5. 将其保存到 <skill_dir>/.social-wallet-secret，内容为 {"appid":"...","appsecret":"..."}
6. 限制权限：chmod 600 <skill_dir>/.social-wallet-secret

通过 API 调用使用社交登录钱包

用户使用社交登录钱包时，所有 bitget-wallet-agent-api.py 调用都必须包含 --wallet-id，以识别钱包会话。walletId 从 profile 端点获取。

步骤 1：获取 walletId（每个会话获取一次）

python3 scripts/social-wallet.py profile
# Returns: {"walletId": "<id>"}

步骤 2：在所有 API 调用中传入 walletId

python3 scripts/bitget-wallet-agent-api.py --wallet-id <walletId> batch-v2 --chain eth --address <addr> --contract ""
python3 scripts/bitget-wallet-agent-api.py --wallet-id <walletId> quote --from-chain ... --to-chain ...
# ... all other commands

如果不使用 --wallet-id，API 会使用默认的 toc_agent 令牌（用于助记词／私钥钱包）。使用 --wallet-id 时，API 会将请求路由到社交登录钱包的后端身份。

命令

# Get wallet profile (walletId)
python3 scripts/social-wallet.py profile

# Sign transaction (ETH/BTC/SOL/Tron + all EVM chains)
python3 scripts/social-wallet.py core sign_transaction '{"chain":"eth","to":"0x...","value":0.1,"nonce":0,"gasLimit":21000,"gasPrice":0.0000001}'

# Sign message
python3 scripts/social-wallet.py core sign_message '{"chain":"eth","message":"hello"}'

# Get address
python3 scripts/social-wallet.py core get_address '{"chain":"eth"}'

# Batch get addresses
python3 scripts/social-wallet.py batchGetAddressAndPubkey '{"chainList":["eth","btc","sol"]}'

支持的链：BTC、ETH、SOL、Tron 和 16 条 EVM 链。完整链列表及各链参数请参阅 docs/social-wallet.md。

---

领域知识

技能领域知识

版本

按日期进行版本管理（YYYY.M.DD-N）。当前版本记录在 frontmatter 中。最多每 7 天检查一次： 将 frontmatter 中的版本与 https://raw.githubusercontent.com/bitget-wallet-ai-lab/bitget-wallet-skill/main/CHANGELOG.md 比较。如果有更新版本，告知用户并询问是否升级。

---

钱包领域知识

首次钱包设置和兑换配置： 请参阅 docs/first-time-setup.md。

关键规则（始终适用）：

• 仅持久化助记词。私钥按需派生、使用后立即丢弃。
• 绝不能向外部传输私钥（API、聊天、HTTP、webhook 等）——仅限本地签名。
• 使用临时文件（mktemp）配合 --private-key-file。切勿将密钥作为 CLI 参数传递。

金额：仅使用人类可读格式

所有 BGW API 金额字段都使用人类可读的数值，而不是最小单位（wei、lamports、代币小数单位）。在兑换流程中，fromAmount（以及 toAmount 等）必须是人类可读的数值（例如，0.01 USDT 应写为 0.01）。不要转换为代币小数单位或 wei／lamports。此规则适用于报价、确认、makeOrder，以及响应中的所有 toAmount／fromAmount。响应中的 decimals 字段仅供参考。

原生代币和地址

• 原生代币（ETH、SOL、BNB 等）的合约地址使用空字符串 ""。原生代币不要使用包装代币地址（例如 WETH、WSOL）。

常见稳定币地址

USDT／USDC 始终使用以下已验证地址。 不要凭记忆猜测或生成合约地址——错误地址会导致 API 错误（error_code: 80000，“get token info failed”）。

USDT 与 USDT0： 在某些链上，Tether 已迁移至 USDT0（全链代币）。相同的合约地址仍然有效；无论何时使用“USDT”，都请使用下方地址。

链（代码）	USDT（USDT0）	USDC
Ethereum (eth)	0xdAC17F958D2ee523a2206206994597C13D831ec7	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
BNB Chain (bnb)	0x55d398326f99059fF775485246999027B3197955	0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d
Base (base)	0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Arbitrum (arbitrum)	0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9	0xaf88d065e77c8cC2239327C5EDb3A432268e5831
Polygon (matic)	0xc2132D05D31c914a87C6611C10748AEb04B58e8F	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
Solana (sol)	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Morph (morph)	0xe7cd86e13AC4309349F30B3435a9d337750fC82D	0xCfb1186F4e93D60E60a8bDd997427D1F33bc372B
Tron (trx)	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t	-

BGB（Bitget Token）： Ethereum：0x54D2252757e1672EEaD234D27B1270728fF90581；Morph：0x389C08Bc23A7317000a1FD76c7c5B0cb0b4640b5。

对于其他代币，在调用兑换端点前，请使用代币信息或区块浏览器验证合约地址。

---

扩展领域知识

强制要求：调用该领域中的任何 API 之前，必须先加载对应文件。 不要跳过——请参阅本 SKILL 开头的强制规则。

模块	文件	加载时机
首次设置	docs/first-time-setup.md	创建新钱包、首次交换配置、派生路径
命令	docs/commands.md	所有脚本的完整子命令参数和用法示例
钱包与签名	docs/wallet-signing.md	密钥管理、BIP-39/44、签名、多链
市场数据	docs/market-data.md	代币信息、价格、K 线、交易信息、排名、流动性、安全性
代币深度分析	docs/token-analyze.md	代币深度分析：K 线信号、交易动态、持有者、聪明钱
地址发现	docs/address-find.md	按角色和表现筛选条件查找 KOL/聪明钱地址
交换	docs/swap.md	交换流程、报价/确认/makeOrder/send、滑点、Gas、授权
RWA 股票交易	docs/rwa.md	RWA 股票发现、配置、市场状态、订单价格、持仓
x402 支付	docs/x402-payments.md	HTTP 402、EIP-3009、Permit2、Solana 部分签名
代币转账 / 免 Gas	docs/transfer.md	直接链上转账流程、免 Gas 模式、EIP-7702 签名、Solana 部分签名
链参考	docs/social-wallet.md	社交登录钱包：各链的 sign_transaction 参数、BTC UTXO/PSBT、SOL SPL、Tron

---

常见问题

1. 链代码： 使用 sol 而非 solana，使用 bnb 而非 bsc。请参阅下方的链标识符。
2. 批量格式： 例如，batch-token-info 使用 --tokens "sol:<addr1>,eth:<addr2>"（链:地址，以逗号分隔）。
3. 报价过期： 如果距离执行超过约 30 秒，请重新获取报价；价格可能已经变动。
4. Gas 不足： 如果钱包缺少支付 Gas 的原生代币，交换可能会失败。继续前请检查余额。
5. 代币授权（EVM）： ERC-20 必须授权给路由器；请参阅 docs/swap.md 中的“EVM Token Approval”。
6. 查询余额/交换前先配置钱包： 如果尚未配置钱包，请引导用户完成首次钱包设置（请参阅上方的“钱包领域知识”）。
7. 脚本用法： 使用本 SKILL 中的 CLI 命令（例如 bitget-wallet-agent-api.py、order_sign.py）。
8. 密钥安全： 根据助记词即时派生私钥，写入临时文件（mktemp），再通过 order_sign.py --private-key-file 传入（脚本会读取并自动删除）。切勿存储密钥，也不要在聊天中输出助记词/密钥。
9. 人类可读的金额： fromAmount 等参数应传入面向用户的数值（例如 0.01），而不是 wei/lamports/小数位单位。
10. 安全性： 助记词和私钥绝不能出现在对话、提示词或任何输出中。上下文中只能包含助记词文件路径和派生出的地址。
11. API 错误 → 先检查领域知识： API 调用返回错误时，重试或排查前请重新阅读对应的 docs/*.md 文件。大多数错误（参数错误、缺少步骤、流程不正确）都已记录在领域知识中。不要猜测修复方法——请查阅文档。

---

链标识符

支持交换的链（8 条）：

链	ID	代码
Ethereum	1	eth
Solana	100278	sol
BNB Chain	56	bnb
Base	8453	base
Arbitrum	42161	arbitrum
Polygon	137	matic
Morph	100283	morph
Tron	728126428	trx

原生代币合约（ETH、SOL、BNB 等）请使用空字符串 ""。

---

脚本

scripts/ 中有 4 个脚本，要求 Python 3.9+。完整的子命令详情和示例：docs/commands.md。

脚本	用途	主要命令
bitget-wallet-agent-api.py	统一 API 客户端	余额、查找代币（launchpad-tokens/search-tokens-v3/rankings）、检查代币（security/coin-dev/coin-market-info/kline/tx-info）、分析代币（simple-kline/trading-dynamics/transaction-list/holders-info/profit-address-analysis/top-profit/compare-tokens）、查找地址（recommend-address-list）、兑换流程（quote→confirm→make-order→send→get-order-details）
order_make_sign_send.py	一次性执行兑换（助记词/私钥）	一次运行完成 makeOrder + 签名 + 发送。使用 --private-key-file（EVM）或 --private-key-file-sol（Solana）。避免 60s 过期。
transfer_make_sign_send.py	一次性转账代币（助记词/私钥）	一次运行完成 makeTransferOrder + 签名 + 提交。使用 --private-key-file（EVM）或 --private-key-file-sol（Solana）。--gasless 用于免 Gas 模式。
social_transfer_make_sign_send.py	一次性转账代币（Social Login Wallet）	一次运行完成 makeTransferOrder + 签名（TEE）+ 提交。必须提供 --wallet-id。无需本地私钥。--gasless 用于免 Gas 模式。
social_order_make_sign_send.py	一次性执行兑换（Social Login Wallet）	一次运行完成 makeOrder + 签名（TEE）+ 发送。必须提供 --wallet-id。无需本地私钥。
order_sign.py	为 makeOrder 数据签名	输出签名的 JSON 数组。支持原始交易、EVM gasPayMaster（eth_sign）、EIP-712、Solana Ed25519、Solana gasPayMaster。
x402_pay.py	x402 支付	EIP-3009 签名、Solana 部分签名、HTTP 402 支付流程
social-wallet.py	Social Login Wallet	通过 Bitget Wallet TEE 对交易/消息签名（无需本地私钥）

快速参考

# Asset overview (general balance query — supports all chains including Tron; returns balance + price + token info)
python3 scripts/bitget-wallet-agent-api.py batch-v2 --chain bnb --address <addr> --contract <token>

# Swap pre-check balance (verify fromToken + native gas; swap-supported chains: eth/sol/bnb/base/arbitrum/matic/morph/trx)
python3 scripts/bitget-wallet-agent-api.py batch-v2 --chain bnb --address <addr> --contract "" --contract <token>

# Token find (bgw_token_find)
python3 scripts/bitget-wallet-agent-api.py launchpad-tokens --chain sol --platforms pump.fun --stage 1 --mc-min 10000 --holder-min 100
python3 scripts/bitget-wallet-agent-api.py search-tokens-v3 --keyword pepe --chain sol --order-by market_cap
python3 scripts/bitget-wallet-agent-api.py rankings --name Hotpicks  # or topGainers, topLosers

# Token check (bgw_token_check)
python3 scripts/bitget-wallet-agent-api.py coin-market-info --chain sol --contract <addr>
python3 scripts/bitget-wallet-agent-api.py security --chain bnb --contract <addr>
python3 scripts/bitget-wallet-agent-api.py coin-dev --chain sol --contract <addr>

# Token analyze (bgw_token_analyze)
python3 scripts/bitget-wallet-agent-api.py simple-kline --chain sol --contract <addr> --period 1h --size 24
python3 scripts/bitget-wallet-agent-api.py trading-dynamics --chain sol --contract <addr>
python3 scripts/bitget-wallet-agent-api.py transaction-list --chain sol --contract <addr> --only-barrage
python3 scripts/bitget-wallet-agent-api.py holders-info --chain sol --contract <addr>
python3 scripts/bitget-wallet-agent-api.py profit-address-analysis --chain sol --contract <addr>
python3 scripts/bitget-wallet-agent-api.py top-profit --chain sol --contract <addr>
python3 scripts/bitget-wallet-agent-api.py compare-tokens --chain-a sol --contract-a <addr1> --chain-b sol --contract-b <addr2> --period 1h --size 24

# Address find (bgw_address_find)
python3 scripts/bitget-wallet-agent-api.py recommend-address-list --group-ids 1 --filter-chain sol --sort-field win_rate
python3 scripts/bitget-wallet-agent-api.py recommend-address-list --group-ids 2 --filter-win-rate-min 80 --data-period 30d

# Swap flow
python3 scripts/bitget-wallet-agent-api.py quote --from-chain bnb --from-contract <addr> --from-symbol USDT --from-amount 5 --to-chain bnb --to-contract "" --to-symbol BNB --from-address <wallet> --to-address <wallet>
python3 scripts/bitget-wallet-agent-api.py confirm ... --market <id> --protocol <proto> --slippage <val> --feature user_gas
python3 scripts/order_make_sign_send.py --private-key-file /tmp/.pk_evm --order-id <id> --from-chain bnb ... --market ... --protocol ...
# Social Login Wallet: one-shot swap (no private key needed)
python3 scripts/social_order_make_sign_send.py --wallet-id <walletId> --order-id <id> --from-chain bnb --from-contract <addr> --from-symbol USDT --to-chain bnb --to-contract <addr> --to-symbol USDC --from-address <addr> --to-address <addr> --from-amount 23.35 --slippage 0.005 --market bgwevmaggregator --protocol bgwevmaggregator_v000
python3 scripts/bitget-wallet-agent-api.py get-order-details --order-id <id>

# Transfer flow (bgw_transfer)
# Mnemonic/private-key wallet (EVM)
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain eth --contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --from-address <addr> --to-address <addr> --amount 100
# Mnemonic/private-key wallet (EVM gasless)
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain base --contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
  --from-address <addr> --to-address <addr> --amount 50 --gasless
# Mnemonic/private-key wallet (Solana gasless)
python3 scripts/transfer_make_sign_send.py --private-key-file-sol /tmp/.pk_sol \
  --chain sol --contract Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB \
  --from-address <addr> --to-address <addr> --amount 10 --gasless
# Social Login Wallet (no private key needed)
python3 scripts/social_transfer_make_sign_send.py --wallet-id <walletId> \
  --chain bnb --contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-address <addr> --to-address <addr> --amount 1 --gasless
# Poll transfer status
python3 scripts/bitget-wallet-agent-api.py get-transfer-order --order-id <id>

---

安全规则

• 助记词和私钥绝不能出现在对话、提示词、日志或任何输出中。 只有派生出的地址可以存储在上下文中或展示。私钥从安全存储中的助记词派生，用于签名后立即丢弃。
• 对于大额交易，务必先展示报价并征求用户确认。
• 在建议采取任何代币操作之前，先展示安全审计结果。
• API 返回的值必须原样使用。 当 API 响应返回某个字段（例如 market.id、market.protocol、contract、orderId）时，后续 API 调用必须逐字传入该值。绝不能猜测、推断、转换或替换这些值——即使看起来相似的值似乎正确也不行。值不匹配会导致静默失败或系统错误。