← Back to Blog

How to Check BNB Smart Chain Wallet Balance with an AI Agent

BNB Smart Chain processes more daily transactions than any other EVM chain — at a fraction of Ethereum's gas cost. Run an AI agent to monitor BNB wallet balances, track Binance ecosystem activity, and run high-frequency on-chain checks without paying for a data provider.

What You Need

• Node.js 18+ installed, or the OE Runtime binary from openenthrium.com/runtime
• An API key from OpenAI, Anthropic, or any supported LLM provider
• A free public BNB Chain RPC endpoint — no separate account needed (included in the config below)
• A text editor — nothing else

---

Create the Project Folder

Create a folder called bnb-agent/ and add these two files:

The Skill Files

SKILL.md

---
name: bnb-agent
description: Check BNB wallet balance
license: Apache-2.0
metadata:
  author: Open Enthrium
  version: "1.0"
---

You are a blockchain data agent. Use the tools to fetch data and respond concisely.

## Step 1: Check Balance
Get the BNB balance for the configured wallet address.
Report the address and balance in BNB. Nothing else.

agent.yaml

name: BNB Agent
description: Check BNB wallet balance
connectors:
  - connection_name: BNB
    connection_type: web3
skills:
  - path: ./
    trigger_type: auto

The Config File

bsc.publicnode.com is a free, rate-limit-friendly BSC RPC endpoint — no API key required:

{
  "llm": {
    "provider": "openai",
    "model": "gpt-4o",
    "apiKey": "sk-..."
  },
  "server": {
    "enabled": false,
    "port": 3333,
    "apiKey": "your-secret-api-key"
  },
  "connectors": [
    {
      "connection_name": "BNB",
      "connection_type": "web3",
      "baseUrl": "https://bsc.publicnode.com",
      "walletAddress": "0xYOUR_WALLET_ADDRESS"
    }
  ]
}

Download OE Runtime

Run the Agent

From the parent folder containing your skill directory:

	Method	Best for	Download
1	npx recommended	No install needed — always runs the latest version	—
2	Windows .exe	Download once, run offline on Windows	⊞ Windows (.exe)
3	macOS binary	Download once, run offline on Mac	 macOS
4	Linux binary	Server deployments, cron jobs, Docker	🐧 Linux
5	API Server integration	Call from any app, webhook, or automation pipeline	📮 Postman Collection

1 npx recommended

npx -y @openenthrium/oe-runtime@latest ./bnb-agent

2 Windows

oe-runtime-win.exe ./bnb-agent

3 macOS

chmod +x oe-runtime-macos
./oe-runtime-macos ./bnb-agent

First run blocked? System Settings → Privacy & Security → Allow Anyway.

4 Linux

chmod +x oe-runtime-linux
./oe-runtime-linux ./bnb-agent

5 API Server integration

Add a "server" block to oe-config.json, then start with --serve:

{
  "llm": { ... },
  "server": { "enabled": true, "port": 3333, "apiKey": "your-secret-key" },
  "connectors": [ ... ]
}

npx -y @openenthrium/oe-runtime@latest --serve --config oe-config.json

Run with inline YAML:

curl -X POST http://localhost:3333/run \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-secret-key" \
  -d '{"yaml": "...", "params": {}}'

Or run from a file on the server:

curl -X POST http://localhost:3333/run-file \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-secret-key" \
  -d '{"file": "/path/to/agent.yaml", "params": {}}'

Enterprise Use Cases on BSC

• High-frequency treasury monitoring — BNB's sub-cent gas cost makes it practical to run balance checks every few minutes. Monitor company BEP-20 token holdings and BNB reserves without incurring meaningful on-chain costs.
• PancakeSwap LP position tracking — Track the BNB balance of wallets actively providing liquidity on PancakeSwap. Flag wallets approaching exit thresholds or showing unusual withdrawal patterns.
• Token launch treasury surveillance — Many new token projects launch on BSC first. Monitor the developer wallet for a new token to verify vesting lock-up commitments and flag premature wallet movements.
• CEX-to-chain flow analysis — Binance is the largest BNB on-ramp. Track the inflow of BNB from exchange withdrawal addresses to known protocol wallets, giving a view of retail and institutional capital flows.
• Validator reward reconciliation — BSC validators earn BNB staking rewards. Automatically reconcile validator wallet balances against expected reward accruals to detect discrepancies in staking operations.
• Compliance screening at scale — BSC's low fees make it the chain of choice for high-volume token transfers. Run automated compliance checks on counterparty wallets before processing large BEP-20 token settlements.