bitget-wallet-skill

Bitget Wallet Skill

Overview

An AI Agent skill that wraps the Bitget Wallet API, enabling natural-language-driven on-chain data queries and swap operations.

Design Principles

Market Tools Architecture

Market side handles token discovery and analysis only — no trading, wallet, or signing. Skills layer computes scores and rules; backend provides raw data.

Atomic Tools (Agent orchestrates)
├── bgw_token_find      Find tokens (chain scan / search / rankings / sectors)
├── bgw_token_check     Check tokens (security / dev / anti-manipulation / signals / market)
├── bgw_token_analyze   Analyze tokens (deep: timeline / trades / holdings / smart money)
├── bgw_alpha           Alpha intelligence (gems / signals)
├── bgw_address_find    Find addresses (by pool / role / criteria)
└── bgw_address_analyze Analyze addresses (scoring / PnL / style / operations / comparison)

Smart Tools (We orchestrate)
├── bgw_combo    Smart combos (token + address permutation recipes)
└── bgw_monitor  Continuous monitoring (token signals / address activity / price alerts)

Core Capabilities

⚠️ Swap amounts are human-readable — pass 0.1 for 0.1 USDT, NOT 100000000000000000. The toAmount in responses is also human-readable. This differs from most on-chain APIs.

✨ Order Mode — Gasless & Cross-Chain Swaps

The swap flow enables two capabilities no other AI agent swap skill offers:

⛽ Gasless Transactions (EIP-7702)

• Swap tokens with zero native token balance — no ETH, no BNB, no MATIC needed
• Gas cost is deducted from the input token automatically
• Agent only signs; a backend relayer pays gas and broadcasts the transaction
• Supported on all EVM chains (Ethereum, Base, BNB Chain, Arbitrum, Polygon, Morph)

🌉 One-Step Cross-Chain Swaps

• Swap tokens across different chains in a single order — no manual bridging
• Example: USDC on Base → USDT on BNB Chain, one API call, one signature
• Combined with gasless: cross-chain swap with zero gas on the source chain

How it works:

1. quote          → Get multi-market quotes
2. confirm        → Final quote from chosen market, get orderId
3. makeOrder      → Create unsigned transaction data
4. Sign           → Agent signs with wallet key
5. send           → Submit signed data
6. getOrderDetails → Track until success

Example — Same-chain swap:

# Quote: BNB USDT → USDC
python3 scripts/bitget-wallet-agent-api.py quote \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress

# Confirm with chosen market
python3 scripts/bitget-wallet-agent-api.py confirm \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress \
  --market bgwevmaggregator --protocol bgwevmaggregator_v000 \
  --slippage 0.01 --feature user_gas

💳 x402 Payments — Pay-Per-Request API Access

x402 is an open standard for HTTP-native payments. When an agent encounters a paid API (HTTP 402), it signs a USDC authorization and retries — no accounts, no API keys needed.

How it works:

1. Agent requests a resource → gets HTTP 402 + payment requirements
2. Agent signs EIP-3009 TransferWithAuthorization (gasless, off-chain)
3. Agent retries with PAYMENT-SIGNATURE header
4. Service's facilitator settles on-chain → agent gets the resource

Key features:

• Truly gasless — agent pays only USDC, facilitator sponsors gas
• No accounts needed — wallet address is your identity
• Works with any x402 service — Pinata IPFS, DiamondClaws DeFi data, and 100+ more

# Example: pay $0.001 for Pinata IPFS upload
python3 scripts/x402_pay.py pay \
  --url "https://402.pinata.cloud/v1/pin/private?fileSize=100" \
  --private-key <key> --method POST --data '{"fileSize": 100}' --auto

See docs/x402-payments.md for domain knowledge, signing details, and testing guide.

💸 Gasless Token Transfer

Direct on-chain token transfer where the server handles transaction construction, broadcasting, and tracking. Supports gasless mode — gas fees paid from stablecoin balance (USDT/USDC) instead of native tokens.

How it works:

transfer_make_sign_send.py / social_transfer_make_sign_send.py
  → makeTransferOrder + sign + submitTransferOrder (one shot)
  → poll getTransferOrder until SUCCESS or FAILED

Key features:

• Gasless (EIP-7702 / FeePayer) — transfer tokens with zero native gas. Gas deducted from USDT/USDC balance
• Multi-chain — ETH, BNB, Base, Arbitrum, Polygon, Morph, Solana
• Server-side broadcast — client only signs, server handles nonce management and chain tracking
• Explicit fallback — if gasless is unavailable, prompts for confirmation before falling back to standard transfer

# Standard EVM token transfer
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain eth --contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --from-address 0xAbC... --to-address 0xDeF... --amount 100

# Gasless transfer (no ETH needed for gas)
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain base --contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
  --from-address 0xAbC... --to-address 0xDeF... --amount 50 --gasless

# Poll status
python3 scripts/bitget-wallet-agent-api.py get-transfer-order --order-id <orderId>

See docs/transfer.md for domain knowledge, signing modes, and gasless details.

Supported Chains

Ethereum · Solana · BNB Chain · Base · Arbitrum · Tron · TON · Sui · Optimism and more.

Architecture

Natural Language Input
    ↓
AI Agent (OpenClaw / Dify / Custom)
    ↓
bitget-wallet-agent-api.py (Python 3.9+)
    ↓  ← Token auth (no API key needed)
Bitget Agent API (copenapi.bgwapi.io)
    ↓
Structured JSON → Agent interprets → Natural language response

Security by Design:

• No API key or HMAC signing needed — uses token-based authentication
• Swap calldata generates transaction data; signing requires explicit wallet key access
• Wallet key management: mnemonic stored in secure storage, private keys derived on-the-fly and discarded after each signing operation (never persisted)

Agent Use Cases

1. Personal Research Assistant

"Check if this Solana meme coin is safe, and give me a price quote."

• Token info + security audit + price in a single query
• For: individual traders, researchers
• Platforms: Telegram Bot, Discord Bot, OpenClaw

2. Portfolio Management Agent

"What's my total portfolio value right now?"

• Batch query across chains and tokens, calculate net value
• Scheduled snapshots + K-line data for historical tracking
• For: DeFi users, fund managers
• Platforms: OpenClaw cron + Telegram alerts

3. Market Monitoring / Alert Agent

Automatically scan top gainers, detect anomalies, push alerts

• Rankings + transaction volume + security audit combined
• Discover trending tokens → auto-run security audit → filter honeypots → notify user
• For: on-chain alpha hunters
• Platforms: Cron jobs, Dify workflows

4. Semi-Automated Trading Agent

"Buy this token with 1 SOL"