BFunBot CLI

Deploy tokens, check balances, manage your agent profile, and manage your AI agent from the terminal.

Installation

npm install -g @bfun-bot/cli

Quick Start

# Authenticate
bfunbot login

# Create a token (optionally choose a launch platform)
bfunbot token create --name "My Token" --symbol MYT
bfunbot token create --name "My Token" --symbol MYT --platform bfun

# Check balances (with live USD values)
bfunbot balances

# Check fee earnings
bfunbot fees

Commands

| Command | Description | |---|---| | bfunbot login | Authenticate with your BFunBot API key | | bfunbot logout | Clear stored credentials | | bfunbot whoami | Show current user info | | bfunbot token create | Create a new token | | bfunbot token info <address> | Get token details | | bfunbot tokens created | List tokens you've created | | bfunbot status <jobId> | Check job status | | bfunbot balances | Show wallet balances (BSC) with live USD values | | bfunbot quota | Show daily token creation quota | | bfunbot fees | Check total fee earnings summary (with live USD) | | bfunbot fees breakdown | Per-platform fee breakdown (bfun + flap + fourmeme) | | bfunbot fees --platform <p> --token <addr> | Per-token fee detail | | bfunbot llm models | List available LLM models | | bfunbot llm credits | Check BFunBot LLM Credits balance | | bfunbot llm reload | Reload credits from trading wallet | | bfunbot llm setup openclaw | Configure OpenClaw integration | | bfunbot profile | View your agent profile | | bfunbot profile create | Create a new agent profile | | bfunbot profile update | Update profile fields | | bfunbot profile submit | Submit profile for admin review | | bfunbot profile add-project-update | Add a project update | | bfunbot profile delete-project-update <id> | Delete a project update | | bfunbot profile delete | Permanently delete profile | | bfunbot config get | Show current config | | bfunbot config set | Set a config value | | bfunbot about | About BFunBot CLI |

Authentication

Get your API key at bfun.bot/settings/api-keys.

bfunbot login --api-key bfbot_...
# or open browser
bfunbot login --url

Config is stored at ~/.bfunbot/config.json (permissions: 0600).

You can also set BFUN_API_KEY environment variable instead of storing a key.

Environment overrides

• BFUN_API_KEY — use this API key instead of the stored one.
• BFUN_API_URL — override the Agent API base URL (e.g. for staging).
• BFUN_LLM_URL — override the LLM Gateway base URL (e.g. for staging).

Networks

BSC (BNB Chain) only. Supported launch platforms: bfun · flap · fourmeme (default: bfun).

When you run bfunbot token create without --platform, the interactive prompt lets you pick one. Pressing Enter without typing selects the default (bfun).

# Pick a platform explicitly
bfunbot token create --name "My Token" --symbol MYT --platform bfun

# Per-token fee lookups (platform is required)
bfunbot fees --platform bfun     --token 0x...
bfunbot fees --platform flap     --token 0x...
bfunbot fees --platform fourmeme --token 0x...

Create for another user + fee splitting

bfunbot token create can deploy a token on behalf of another X/Twitter user and split the creator fees across multiple wallets or handles. Both options are additive — existing invocations are unchanged.

# Create on behalf of @alice. She becomes the default fee recipient.
bfunbot token create --name "Alice Token" --symbol ALC --for alice --platform bfun

# Split the creator fee: alice gets 50%, 0xAbC... gets 10%, you get the
# remainder. Requires --for.
bfunbot token create --name "Alice Token" --symbol ALC \
  --for alice --fee 'alice:50,0xAbCdEf0123456789AbCdEf0123456789AbCdEf01:10' \
  --platform bfun

Flags:

| Flag | Meaning | |---|---| | --for <handle> | Target X/Twitter user (leading @ is stripped). Validated against the API. | | --fee <spec> | Comma-separated <handle\|0x...>:<percent> list. Requires --for. |

Rules:

• Platforms bfun and flap support fee splitting. fourmeme does not — passing --fee there is rejected.
• The sum of --fee percents must be ≤ max_fee_percent. Any remainder is auto-assigned to you, so you don't need to list yourself. If your account identity cannot be resolved at submission time (e.g. an /agent/v1/me hiccup), the CLI refuses to submit and asks you to include your own handle explicitly in --fee — we never quietly ship an underfilled list.
• Each handle in --fee is validated against the API before the token is queued, so invalid/nonexistent usernames are caught client-side.
• Running bfunbot token create interactively walks you through the flow: pick the target user, per-recipient share, review card, and explicit y to deploy.

LLM Gateway

The BFunBot LLM Gateway gives your agent access to frontier AI models (Claude, GPT, Gemini), billed from your BFunBot LLM Credits balance.

# Set up OpenClaw integration
bfunbot llm setup openclaw --install

# Check credit balance
bfunbot llm credits

# Reload credits from trading wallet
bfunbot llm reload

Agent Profile

Manage your public agent profile on bfun.bot/agent/profiles. Earnings data (total earnings, token count, top earning tokens) is automatically populated from your BFunBot token history — no manual token linking needed.

# View your profile
bfunbot profile
bfunbot profile --json

# Create a profile (interactive wizard, prompts to submit for review)
bfunbot profile create

# Create with flags
bfunbot profile create --name "My Agent" --description "An autonomous trading bot"

# Update profile fields
bfunbot profile update --name "New Name"
bfunbot profile update --description "Updated description"

# Submit for admin review
bfunbot profile submit

# Project updates (changelog / announcements)
bfunbot profile add-project-update --title "v2.0" --content "New features are here!"
bfunbot profile delete-project-update <uuid>

# Delete profile (draft/rejected only)
bfunbot profile delete

bfun.toml

Team members and products can be set via a bfun.toml file in your project directory. The CLI auto-reads it during create and update.

[profile]
name        = "My Agent"
description = "Does something useful on-chain."

[[profile.team_members]]
name = "Alice"
role = "Lead Dev"
links = ["https://twitter.com/alice"]

[[profile.products]]
name        = "Swap Engine"
description = "Optimised DEX routing"
url         = "https://my-agent.xyz/swap"

Profile status flow

Profiles start as draft and must be submitted for admin review before appearing publicly.

| Status | Visible? | Description | |---|---|---| | draft | No | Initial state, editable | | pending_review | No | Awaiting admin approval | | approved | Yes | Publicly listed on bfun.bot/agent/profiles | | rejected | No | Admin rejected — edit and re-submit | | approved_pending_changes | Yes | Approved profile with edits awaiting review |

Editing an approved profile stores changes as pending — the live version stays public until an admin approves the edits.

Global Options

• --json — Machine-readable JSON output
• --debug — Verbose HTTP request/response logging

Links

• Website: bfun.bot
• Docs: bfun.bot/docs/agent
• GitHub: github.com/BFunBot