lium fund

Fund your account with TAO — or alpha — from a Bittensor wallet.

lium fund [OPTIONS]

Run without flags for an interactive prompt that walks you through wallet and amount — and, under --alpha, the origin hotkey.

Alpha funding moves only your free alpha

With --alpha, the transfer uses your free alpha only — your stake minus any locked amount. If you ask to move more alpha than you have free, the transfer is not attributed and your balance is not credited at all. Keep the amount at or below your free alpha.

Alpha earns the deposit bonus on every accepted subnet

lium fund --alpha has no subnet flag — it always pays from the subnet Lium quotes at transfer time, and aborts if that subnet changes mid-flight. To choose a subnet, use Top up → Alpha on lium.io/billing. Its Pay from subnet picker is the live list of subnets you can pay from, and the BTCLI command tab prints the matching command with the netuid, destination coldkey and alpha amount already filled in:

btcli stake transfer --origin-netuid <netuid> --dest-netuid <netuid> --dest <lium-coldkey> --amount <alpha>

Copy that command from the modal rather than writing it yourself: <lium-coldkey> is resolved per account, and the wallet you send from must be verified there first — an unverified sender is not attributed and your balance is not credited. A deposit on a subnet Lium does not accept is likewise not credited, and not refunded.

Options

Flag	Effect
--wallet, -w NAME	Wallet name
--hotkey, -k NAME	Origin hotkey the alpha is staked under. Alpha only — required with --alpha, ignored otherwise.
--amount, -a AMOUNT	Amount to fund. TAO by default; USD when --alpha is set.1
--alpha	Fund with free alpha stake (via transfer_stake) instead of TAO.
--json	Print machine-readable JSON (non-interactive; pass --yes).
--yes, -y	Skip confirmation

Examples

lium fund                                         # Interactive (TAO)
lium fund -w default -a 10.0                       # Fund 10 TAO
lium fund -w mywallet -a 5.0 -y                    # No prompts (TAO)

# Alpha funding — -a is USD, -k (origin hotkey) is required
lium fund --alpha -k <hotkey-ss58> -a 25           # Fund ~$25 of free alpha
lium fund --alpha -w default -k myhotkey -a 25     # -k may be a wallet hotkey name
lium fund --alpha -k <hotkey-ss58> -a 25 -y --json # Non-interactive, JSON output

See also

• lium ps — see hourly burn rate after funding

Footnotes

1. Under --alpha the amount is denominated in USD. Lium quotes the alpha to move and the destination subnet at transfer time, then credits the actual alpha moved revalued at on-chain inclusion time, so the credited USD can differ slightly from the quote. ↩