Wallbit CLI

Command-line interface for the Wallbit API, built on the Go SDK wallbit-go. It covers balances, assets, fees, trades, YAML workflows, and more.

Installation

Current release: v0.2.0

Install a fixed version (recommended for reproducible installs):

go install github.com/jeremyjsx/wallbit-cli/cmd/wallbit@v0.2.0

Requires Go 1.23 or newer.

Install the latest commit on main from the Go module proxy:

go install github.com/jeremyjsx/wallbit-cli/cmd/wallbit@latest

Build from a clone:

go build -o wallbit ./cmd/wallbit

Release binaries: inject the reported version with -X on internal/cli.Version:

go build -ldflags "-X github.com/jeremyjsx/wallbit-cli/internal/cli.Version=v0.2.0" -o wallbit ./cmd/wallbit

Authentication

API key resolution order:

1. Global --api-key flag
2. WALLBIT_API_KEY environment variable
3. Credential stored via wallbit auth login

wallbit auth login    # interactive; stores key in user config dir
wallbit auth status   # shows whether a key is configured (never prints it)
wallbit auth logout   # removes locally stored key

Global flags

Flag	Description
--api-key	API key (optional if env or login is set)
--base-url	API base URL (default https://api.wallbit.io)
--timeout	HTTP client timeout (default 30s)
--version, -v	Binary version

After go install at tag v0.2.0 (or with -ldflags as above), wallbit --version prints that version. From a raw checkout without tags, it may show (devel) based on Go build metadata.

Quick start

wallbit balance checking
wallbit workflow validate workflow.yaml
wallbit workflow run workflow.yaml
wallbit --help

Top-level commands include auth, registry, balance, assets, rates, fees, trades, transactions, wallets, cards, operations, roboadvisor, account-details, apikey, and workflow. Run wallbit help for the full command tree.

Workflows (YAML)

Workflow steps use run keys implemented by this CLI (balances, fees, operations, etc.). Validate before running:

wallbit workflow validate my-flow.yaml
wallbit workflow run my-flow.yaml

Workflow registry

Publish and download shared workflows from the wallbit-registry API. Pull is public; publish requires a registry API key (wb_reg_…) from the registry web app (wallbit-registry.vercel.app) under Account → API keys.

Registry API key resolution (publish only):

1. --registry-api-key on wallbit workflow commands
2. WB_REG_KEY environment variable
3. Credential stored via wallbit registry login

wallbit registry login
wallbit registry status

# Download (no registry key required)
wallbit workflow pull author/slug@1.0.0 -o my-flow.yaml
wallbit workflow pull author/slug -o my-flow.yaml   # latest version

# Publish (registry username must be set in the web account first)
wallbit workflow publish ./my-flow.yaml --version 1.0.0 --slug my-flow

Registry URL resolution: --registry-url, then REGISTRY_URL, then WALLBIT_REGISTRY_URL, then the production default (https://wallbit-registry-production.up.railway.app). Override for local development:

export REGISTRY_URL=http://localhost:8080

workflow run still uses your Wallbit API key (WALLBIT_API_KEY / wallbit auth login), not the registry key.

Related

Resource	Link
Go SDK	jeremyjsx/wallbit-go
Workflow registry	wallbit-workflows/wallbit-registry
Releases	wallbit-cli releases