Command reference
Binary: sbc · Package: @stablecoin.xyz/cli
Global flags: --output json | --output text (default).
Authentication
Login/logout are user-scoped by default. Agent auth lives under an explicit agent path.
User (sk_user_…)
| Command | Description |
|---|---|
sbc login | Log in as a user (save user key) |
sbc logout | Log out the user. Add --all to also remove the agent key |
sbc auth login / sbc auth logout | Same as above |
sbc user login / sbc user logout | Same as above |
sbc auth user login / sbc auth user logout | Same as above |
Agent (sk_live_…)
| Command | Description |
|---|---|
sbc agent login / sbc agent logout | Log in / out as an agent |
sbc agent auth login / sbc agent auth logout | Same as above |
sbc auth agent login / sbc auth agent logout | Same as above |
Whoami
| Command | Description |
|---|---|
sbc whoami | Show all active keys and user info (summary) |
sbc auth whoami | Same summary |
sbc user whoami / sbc auth user whoami | Authenticated user info via API |
sbc agent whoami / sbc auth agent whoami | Active agent key and agent ID |
Manage agents
Requires a user key (sk_user_…).
| Command | Description |
|---|---|
sbc agent list | List your agents |
sbc agent show <id> | Agent details, wallet, limits, recent transactions |
sbc agent create | Create an agent with a managed wallet |
sbc agent archive <id> | Archive an agent |
sbc agent send | Alias for sbc send |
sbc agent pay | Alias for sbc pay |
sbc agent swap | Alias for sbc swap |
Example:
sbc agent create --name "My Agent" --chain base
sbc agent show <id>Manage seller endpoints
Requires a user key (sk_user_…).
| Command | Description |
|---|---|
sbc endpoint list | List seller endpoints |
sbc endpoint show <id> | Endpoint details |
sbc endpoint create | Create an endpoint with a managed wallet |
sbc endpoint create … --tokens SBC,cfUSD | Restrict accepted tokens (cfUSD only on Base) |
sbc endpoint archive <id> | Archive an endpoint |
sbc endpoint balance <id> | Endpoint wallet balance |
sbc endpoint payments <id> | List payments received |
sbc endpoint keys list <id> | List API keys |
sbc endpoint keys generate <id> | Generate a seller API key |
sbc endpoint keys revoke <endpointId> --key-id <id> | Revoke a seller API key |
Example:
sbc endpoint create --name "My API" --url https://api.mine.com --price 0.5 --chain base-sepolia
sbc endpoint keys generate <id> --label "production"
# → copy sk_seller_... into your server env as X-Seller-KeyDay-to-day agent usage
| Command | Description |
|---|---|
sbc balance | Agent wallet balances (SBC + cfUSD split on Base) |
sbc balance --token cfUSD | Single token balance |
sbc pay --url <url> | Pay a seller URL (x402 or MPP) |
sbc send --to <addr> --amount <n> | Send SBC (gasless on Base) |
sbc send --to <addr> --amount <n> --token cfUSD | Send cfUSD (Base / Base Sepolia only) |
sbc swap --from <token> --to <token> --amount <n> | Swap on Base via Better Intents |
sbc transactions | Transaction history (requires user key) |
Other
| Command | Description |
|---|---|
sbc manifest | Fetch platform /.well-known/agent.json |
Common workflow
# First-time setup
sbc login --user-key sk_user_...
sbc agent login --agent-key sk_live_...
sbc whoami
# Day-to-day
sbc balance
sbc pay --url https://api.mine.com
sbc send --to 0x... --amount 5
sbc swap --from USDC --to SBC --amount 1
# Seller setup
sbc endpoint create --name "My API" --url https://api.mine.com --price 0.5 --chain base-sepolia
sbc endpoint keys generate <id> --label "production"
sbc endpoint balance <id>
sbc endpoint payments <id>
# Switch accounts
sbc logout # user key only
sbc logout --all # agent + user keys
sbc agent logout # agent key onlyNext
- SBC CLI overview — install, architecture, env vars
- x402 Payments