BFunBot Skill

Create tokens on BSC, earn trading fees, and use BFunBot's BFun LLM Gateway — all from natural language commands.

Version: 1.0.0
Provider: BFunBot
Auth: API key required — get yours at bfun.bot/settings/api-keys
Install: install the bfunbot skill from https://github.com/BFunBot/skills/tree/main/bfunbot

---

Setup

Step 1 — Get your API key

Go to bfun.bot/settings/api-keys → Create API Key → copy the bfbot_... key.

Permissions: Base API is always included. Enable BFun LLM Gateway if you want to use AI models. Enable Agent Reload if you want the agent to top up your BFun.bot Credits automatically from your trading wallet.

Step 2 — Add BFun.bot Credits (for AI model access)

Go to bfun.bot/credits → Add Credit. Minimum $1 to start. Credits are consumed per token used.

Step 3 — Set up BFun LLM Gateway (optional)

This step registers BFunBot as your agent's AI model provider, so your agent thinks using Claude/GPT/Gemini billed to your BFun.bot Credits — instead of paying Anthropic/OpenAI directly. It's separate from the Agent API skill.
OpenClaw users: follow the config below. If you're using LangChain, CrewAI, or any OpenAI-compatible framework, point your base_url to https://llm.bfun.bot/v1 with your bfbot_... API key instead.
OpenClaw users — add BFunBot as an LLM provider in ~/.openclaw/openclaw.json. This is the full config with all available models — you only need to include the models you want to use.

CODEBLOCK0

Note: The agents.defaults.models block is required — it allowlists the models and registers aliases so both the model dropdown picker and /model command work correctly. The alias must match the model id exactly.

Set as default model (optional):
CODEBLOCK1

Then restart OpenClaw:
CODEBLOCK2

Switch models using the dropdown picker or /model command:
CODEBLOCK3

Available Models

Anthropic

Model ID	Context
INLINECODE11	1M
INLINECODE12

200k |
| claude-sonnet-4-6 | 1M |
| claude-sonnet-4-5 | 1M |
| claude-haiku-4-5 | 200k |

OpenAI

Model ID	Context
INLINECODE16	1.05M
INLINECODE17

1.05M |
| gpt-5.4-mini | 400k |
| gpt-5.4-nano | 400k |
| gpt-5.2-pro | 400k |
| gpt-5.2 | 400k |
| gpt-5.2-codex | 400k |
| gpt-5.2-chat | 128k |

Google

Model ID	Context
INLINECODE24	1M
INLINECODE25

1M |
| gemini-3-flash | 1M |
| gemini-2.5-pro | 1M |
| gemini-2.5-flash | 1M |

xAI

Model ID	Context
INLINECODE29	2M

DeepSeek

Model ID	Context
INLINECODE30	164k

Moonshot

Model ID	Context
INLINECODE31	262k

Xiaomi

Model ID	Context
INLINECODE32	1M
INLINECODE33

262k |
| mimo-v2-flash | 262k |

ByteDance

Model ID	Context
INLINECODE35	262k
INLINECODE36

262k |

Alibaba

Model ID	Context
INLINECODE37	262k
INLINECODE38

1M |
| qwen3.5-flash | 1M |

MiniMax

Model ID	Context
INLINECODE40	205k
INLINECODE41

197k |

Z.ai

Model ID	Context
INLINECODE42	203k
INLINECODE43

80k |

Verify by asking your agent: "what's my BFunBot BFun.bot Credits balance?"

---

What This Skill Can Do

BFun LLM Gateway

Use BFunBot-hosted AI models billed against your BFun.bot Credits. Same API key for LLM calls and agent actions.

• - Check balance: "what's my BFunBot BFun.bot Credits balance?"
• Add credits: "I need to top up BFunBot credits" → agent links to bfun.bot/credits
• Reload credits: "reload my BFunBot credits from my trading wallet" (requires Agent Reload permission + configured on Credits page)
• Model info: "what models does BFunBot support?"

Token Creation

Create tokens on BSC — BFunBot handles wallet creation, gas sponsorship, and on-chain deployment.

• - "launch a token called MOON on BSC"
• "create a meme coin named PEPE with ticker $PEPE on fourmeme"
• "make a test token called DEMO on flap"

Token creation is async. After calling the API, poll the job status endpoint until complete (usually 30–60 seconds).

Created Tokens

• - "what tokens have I created on BFunBot?"
• "show my BFunBot token portfolio"

Quota

• - "how many free token launches do I have left today?"
• "what's my BFunBot quota on BSC?"

Wallet Balances

• - "what's my BFunBot wallet balance?"
• "show my BNB and USDT balances on BFunBot"

Fee Earnings

Check creator fee earnings on BSC — data is read from pre-computed DB cache (fast, no on-chain calls).

• - "what are my BFunBot fee earnings?"
• "show my fee earnings summary on BSC"
• "what have I earned from my flap tokens on BSC?"
• "what have I earned from my fourmeme tokens?"
• "how much has token 0x... earned on flap?"

Token Lookup

• - "what's the price of $MOON on BFunBot?"
• "look up token 0x... on BSC"

Account

• - "show me my BFunBot profile"
• "what's my BFunBot Twitter username and wallet address?"

Skills

• - "what can BFunBot do?" → calls GET /agent/v1/skills

---

API Reference

Base URL: https://api.bfun.bot/agent/v1
Auth header: X-Api-Key: bfbot_...

---

GET /me

Returns user profile, wallet addresses, and account info.

Response:

{
  "twitter_user_id": "...",
  "twitter_username": "...",
  "profile_image_url": "...",
  "followers_count": 1234,
  "joined_at": "2025-01-01T00:00:00Z"
}

---

GET /skills

List all available BFunBot Agent API capabilities with examples. No auth required.

Response:

{
  "skills": [
    {
      "name": "token_create",
      "description": "Deploy a new token on BSC",
      "example": "POST /agent/v1/token/create {\"name\": \"MyToken\", \"symbol\": \"MTK\", \"chain\": \"bsc\"}"
    }
  ],
  "total": 9
}

---

POST /token/create

Create a token on BSC (async). Returns a job_id to poll.

Request:
CODEBLOCK6

• - chain: bsc only
• INLINECODE49 (optional): Twitter/X post URL — tweet image used as token image if image_url not provided
• INLINECODE51 (optional): HTTP/HTTPS URL or IPFS URI — overrides source tweet image
• INLINECODE52 (optional): flap | fourmeme — defaults to chain default if omitted

Response (202 Accepted):
CODEBLOCK7

Pre-check errors:

• - 403 insufficient_followers — need minimum followers to create tokens
• INLINECODE57 — free quota used, trading wallet balance too low
• INLINECODE58 — absolute daily cap reached

---

GET /jobs/{job_id}

Poll token creation status.

Response:
CODEBLOCK8

Status values: pending | processing | completed | failed

---

GET /token/{address}

Get token info by address.

Query: ?chain=bsc (optional)

Response:

{
  "token_address": "0x...",
  "name": "MOON",
  "symbol": "MOON",
  "chain": "bsc",
  "platform": "flap",
  "creator_twitter_username": "...",
  "price_usd": "0.0001234",
  "market_cap_usd": "12340",
  "volume_24h_usd": "500",
  "creator_reward_usd": "1.23",
  "created_at": "2026-01-01T00:00:00Z"
}

---

GET /tokens/created

Get paginated list of tokens you have created.

Query: INLINECODE64

Response:

{
  "tokens": [
    {
      "token_address": "0x...",
      "name": "MOON",
      "symbol": "MOON",
      "chain": "bsc",
      "platform": "flap",
      "created_at": "2026-01-01T00:00:00Z"
    }
  ],
  "total": 5,
  "page": 1,
  "page_size": 20,
  "has_more": false
}

---

GET /balance/credits

Get BFun.bot Credits balance and agent reload configuration.

Response:
CODEBLOCK11

INLINECODE65 is null if not configured. enabled: false means agent reload is off.

---

POST /balance/credits/reload

Trigger a BFun.bot Credits reload from the trading wallet.

Requirements:

• - User must have enabled Agent Reload at bfun.bot/credits
• The API key must have INLINECODE68
• The API key must have INLINECODE69
• Trading wallet must have sufficient USDT on BSC
• Daily reload limit must not be exceeded

This is manually triggered by the agent — there is no automatic background polling. Call this endpoint when the agent determines a credit reload is needed.

Response:
CODEBLOCK12

Errors:

• - 403 — reload not enabled for user or key
• INLINECODE71 — daily limit would be exceeded
• INLINECODE72 — insufficient USDT balance on BSC trading wallet
• INLINECODE73 — transaction failed

---

POST /balance/credits/reload/disable

Emergency kill switch — agent disables its own reload permission. Cannot be re-enabled by the agent (human must re-enable via dashboard).

Response: 204 No Content

---

GET /balance/wallet

Get on-chain wallet balances (BSC only — main + trading wallets).

Response:
CODEBLOCK13

Any field may be null if the wallet is not set up or the RPC is unavailable. Check *_error fields for failure reasons.

---

GET /fees/summary

Get total fee earnings on BSC. All data is pre-computed — fast, no on-chain calls.

Response:

{
  "bsc": {
    "chain_id": 56,
    "token_count": 12,
    "total_earned_bnb": 0.053
  }
}

---

GET /fees/earnings

Get per-platform fee breakdown for BSC.

Query: INLINECODE77

Response:

{
  "chain": "bsc",
  "chain_id": 56,
  "flap":     { "total_earned_bnb": 0.042, "earning_token_count": 3 },
  "fourmeme": { "total_earned_bnb": 0.011, "earning_token_count": 1 }
}

---

GET /fees/token

Get fee earnings for a specific token on BSC.

Query: INLINECODE78

• - chain: bsc only
• INLINECODE81: flap | INLINECODE83
• INLINECODE84: contract address

Response:
CODEBLOCK16

Returns 404 if token not found or not owned by the authenticated user.

---

GET /quota

Get daily token creation quota and trading wallet readiness for BSC.

Response:

{
  "chains": [
    {
      "chain": "bsc",
      "free_used_today": 1,
      "free_limit": 3,
      "sponsored_remaining": 2,
      "can_create_paid": true,
      "trading_wallet_balance": "0.010000 BNB",
      "trading_wallet_address": "0x..."
    }
  ]
}

---

BFun LLM Gateway Reference

Base URL: https://llm.bfun.bot
Auth: X-Api-Key: bfbot_... or INLINECODE88

POST /v1/messages (Anthropic format)

Compatible with Claude models via Anthropic Messages API format.

CODEBLOCK18

POST /v1/chat/completions (OpenAI format)

Compatible with all models via OpenAI Chat Completions format.

CODEBLOCK19

GET /v1/models

List available models.

GET /v1/models/openclaw

Returns a ready-to-paste OpenClaw provider config block. No auth required.

---

Error Codes

Code	Meaning
401	Missing or invalid API key
402

Insufficient BFun.bot Credits (LLM) or trading wallet balance (token creation) | | 403 | Permission denied — feature not enabled for this key or user | | 404 | Resource not found | | 422 | Validation error — check request body | | 429 | Rate limited or daily cap exceeded — wait before retrying | | 500 | Server error — retry |

---

Troubleshooting

402 on LLM calls
BFun.bot Credits exhausted. Top up at bfun.bot/credits.
Note: BFun.bot Credits ≠ trading wallet. Topping up one doesn't affect the other.

403 on reload
Either Agent Reload is not enabled for the user (bfun.bot/credits → Agent Reload section), or the API key doesn't have reload_enabled. Check both.

401 Unauthorized
API key missing or invalid. Manage keys at bfun.bot/settings/api-keys.
Ensure you send: INLINECODE90

Token creation stuck at pending
Poll GET /agent/v1/jobs/{job_id} — creation usually takes 30–60 seconds.
If still pending after 5 minutes, check the error field.

429 on reload
Daily reload limit exceeded. Check daily_remaining_usd in the balance response.

400 on reload — insufficient balance
BSC trading wallet doesn't have enough USDT. Check GET /balance/wallet and top up.

---

Full Documentation

• - Agent API: bfun.bot/agent
• API Keys: bfun.bot/settings/api-keys
• BFun LLM Gateway: bfun.bot/llm
• OpenClaw setup: bfun.bot/llm/openclaw
• BFun.bot Credits: bfun.bot/credits